[R] comments on documentation

[Friedrich Leisch]

>>>>> On Wed, 28 Feb 2001 12:10:53 -0300,
>>>>> hzi  (h) wrote:

  > So...Is there such a thing in the R community as a Documentation team (like
  > you have the LDP 0 Linux Documentation Project)?
  > You see, it´s like that japanese martial art Aikido: newbies give you a
  > rough ride, because they don´t know the movements by heart. Likewise, what
  > may seem like a clear explanation to "gurus" may actually be quite
  > unsatisfactory from a newbie´s view point. This is not to say that is poorly
  > written, it´s just that we don´t read the documentation with the same eyes
  > an "experienced" person does. All too often, it has been my experience with
  > the open-source community, the documentation lacks little tiny details that
  > are just so important...

That's why we started the ``contributed documentation'' section on
CRAN. I completely agree that more newbie documentation would be
helpful. It's just a matter of getting it written. I don't think there
currently exists such a thing as a documentation team, but if somebody
volunteers to organize it we'd be more than glad to put the results on
CRAN!

Best,
Fritz

-- 
-------------------------------------------------------------------
                        Friedrich  Leisch 
Institut für Statistik                     Tel: (+43 1) 58801 10715
Technische Universität Wien                Fax: (+43 1) 58801 10798
Wiedner Hauptstraße 8-10/1071      Friedrich.Leisch at ci.tuwien.ac.at
A-1040 Wien, Austria             http://www.ci.tuwien.ac.at/~leisch
-------------------------------------------------------------------

-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-
r-help mailing list -- Read http://www.ci.tuwien.ac.at/~hornik/R/R-FAQ.html
Send "info", "help", or "[un]subscribe"
(in the "body", not the subject !)  To: r-help-request at stat.math.ethz.ch
_._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._._