[R] Wikis etc.
Jack Tanner
ihok at hotmail.com
Sun Jan 8 21:12:57 CET 2006
Philippe's idea to start a wiki that grows out of the content on
http://zoonek2.free.fr/UNIX/48_R/all.html is really great. Here's why.
My hypothesis is that the basic reason that people ask questions on R-help
rather than first looking elsewhere is that looking elsewhere doesn't get
them the info they need.
People think in terms of the tasks they have to do. The documentation for R,
which can be very good, is organized in terms of the structure of R, its
functions. This mismatch -- people think of tasks, the documentation "thinks
in" functions -- causes people to turn to the mailing list.
What we need is documentation that can be browsed in terms of tasks, like
http://zoonek2.free.fr/UNIX/48_R/all.html. If that can be edited by the
community, all the better. This is especially good for newbies (like myself)
who try a tutorial, find that it lacks in some aspect, and can give
immediate feedback, e.g., via a Wiki.
As far as keeping current with the latest versions of R, I think we'll have
to arrive at some sort of convention that says: the code in this example
works with R version X, package version Y. Then, if that code is found to
fail in some future version, it's easy enough to make a second exampe. (As a
bonus, these examples could be an automated test suite for R.)
Philippe, if you find you'd like assistance, I'd like to help.
More information about the R-help
mailing list