Re: [Rd] Phrase "package writer" in R-exts

From: Davor Cubranic <cubranic_at_stat.ubc.ca>
Date: Fri, 01 Apr 2011 17:13:21 -0700

On 2011-04-01, at 12:17 PM, Ted Byers wrote:

> Note, while I see the author's
> responsibility to write perfectly (or at least try), the reader also has a
> responsibility to work at determining what the author meant by what he or
> she wrote.

Most people don't read reference manuals to engage with the author (writer?) and analyze the subtext, but to find relevant information quickly.

For the programmer I was talking to at least (a native English speaker, BTW), R-exts fell short in that respect. When I first heard about his confusion I also thought "how can you miss that?", but now believe that the manual would be improved by replacing "writer" with "author". It is already dense enough with real information, why make it more obscure ?

Davor



R-devel_at_r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel Received on Sat 02 Apr 2011 - 00:19:23 GMT

Archive maintained by Robert King, hosted by the discipline of statistics at the University of Newcastle, Australia.
Archive generated by hypermail 2.2.0, at Sat 02 Apr 2011 - 21:40:40 GMT.

Mailing list information is available at https://stat.ethz.ch/mailman/listinfo/r-devel. Please read the posting guide before posting to the list.

list of date sections of archive