On Fri, Jan 2, 2009 at 5:56 PM, Duncan Murdoch <murd...@stats.uwo.ca> wrote:
> I don't agree. If you add too much technical detail to a topic, then people
> don't "work through it". I'd say the r<dist> pages generally give enough
> detail now, but not too much. If you add every detail that might interest
> someone somewhere, then they'd all be hard to read.
Duncan, Daniel,
Thanks for your responses.
I agree that it's a delicate balance between too little and too much
information on individual documentation pages -- especially when, as
in this case, a number of different functions (r<dist>) share some
content (RNG). That said, I find in general that R documentation
pages are somewhat on the "too little" side. In particular, I'd find
it useful if there were more references to synthetic overviews: a link
from the connection page to an overview of I/O; a link from the runif
page to an overview of distributions; etc.
-s
______________________________________________
R-help@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.
