[Rd] Suggestions for improving R-FAQ
Currently, if you were to print out the R frequently asked questions (http://cran.r-project.org/doc/FAQ/R-FAQ.html), it would be 132 pages long. Is it any wonder that so many question could be answered by looking at the FAQ but are not? Here are a few (contentious) suggestions to improve the document. * Remove the complete list of R packages * Include a complete list of frequently asked questions at the top of the document * Move the introduction to the end - none of this information is immediately useful for the person who is using the document * Move section seven, which includes the most frequently asked questions to the start * Make Why doesn't R think these numbers are equal? the first FAQ since it is the most commonly asked * Remove infrequently asked questions - e.g. 2.3, 2.4, 7.9, 7.11, 7.12, 7.15, 7.19, 7.23, 7.28 * Move sections 3, 6 and 9 into its their own documents Regards, Hadley -- http://had.co.nz/ __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
Re: [Rd] Suggestions for improving R-FAQ
On Tue, Nov 25, 2008 at 12:41 PM, hadley wickham [EMAIL PROTECTED] wrote: Currently, if you were to print out the R frequently asked questions (http://cran.r-project.org/doc/FAQ/R-FAQ.html), it would be 132 pages long. Is it any wonder that so many question could be answered by looking at the FAQ but are not? Here are a few (contentious) suggestions to improve the document. ... + Add a new FAQ - does R use multiple cores. Hadley -- http://had.co.nz/ __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
Re: [Rd] Suggestions for improving R-FAQ
On Tue, Nov 25, 2008 at 3:10 PM, Max Kuhn [EMAIL PROTECTED] wrote: Hadley, These are good suggestions. * Remove infrequently asked questions - e.g. 2.3, 2.4, 7.9, 7.11, 7.12, 7.15, 7.19, 7.23, 7.28 Maybe 7.28 should be titled: How can I make read.table (and read.csv and read.fwf)) faster? But personally, I've never found it made much difference - even with a few hundred thousand rows, it takes longer for me to re-remember the colClasses syntax than load in the data. I'm not sure why I thought 7.23 should go. Sampling bias might be an issue: we don't get questions (to r-help) for those because those are in the FAQ. Perhaps that is wishful thinking on my part. It's a possibility, but it seems unlikely that after paging through 125 pages of material to read 7.23 and 7.28 people would stop before getting to 7.31 -- http://had.co.nz/ __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel