[Rd] NEWS.md support on CRAN

Gavin Simpson ucfagls at gmail.com
Thu Jun 4 19:35:31 CEST 2015

On 4 June 2015 at 11:16, Duncan Murdoch <murdoch.duncan at gmail.com> wrote:

> On 04/06/2015 1:09 PM, Prof Brian Ripley wrote:
>> On 04/06/2015 17:00, Gavin Simpson wrote:
>> ...
>> > 1. Markdown was designed to be as readable as possible in plain text
>> format
>> > (i.e. the sources, not the rendered file). There's nothing stopping you
>> > reading and parsing a NEWS.md in your head trivially.
>> ...
>> That claim is made frequently, but it is not my experience.  That you
>> can filter out markup in your head does not mean others can -- it is
>> very distracting to some visually impaired people (including when using
>> a text-to-speech reader).
>>  I agree.  I think we shouldn't be displaying raw Markdown, except
> possibly as a temporary measure, while we get the parsing and rendering in
> place.

Just to be clear; I wasn't suggesting that R should be displaying raw
Markdown. What I was getting at was even if your local setup stops you
seeing a rendered version of the file (for whatever reason) reading the
Markdown source is a lot easier than reading a similar file marked up using
Rd. Yet for those with less restrictive setups Markdown maintains many of
the benefits that the Rd markup allows.

I just failed miserably, and insensitively(!), to convey that point.


Duncan Murdoch

Gavin Simpson, PhD

	[[alternative HTML version deleted]]

More information about the R-devel mailing list