[R-wiki] To allow modification or not

[Gabor Grothendieck]

I brought this example up before but since the conversation is back
to this the PHP Manual allows placing of comments at the end.
Here is a typical page with user comments at the end:

   http://www.php.net/manual/en/language.types.php

On 2/4/06, Philippe Grosjean <phgrosjean at sciviews.org> wrote:
> Damian Betebenner wrote:
> > All,
> >
> > Wouldn't it be good to allow modification/supplementation of the Examples in the .Rd files put on the Wiki.
> > Perhaps this is what you mean by the "discussion section" at the end that will be editable. One place that
> > some of the help files are currently weak on is the examples. Allowing users to add better examples to
> > the help pages would be a great application of Wiki openess.
>
> Yes, it is what we mean: to be able to add something at the end of the
> Wiki version of the Rd files. Martin said that it would be also
> interesting to do so with the manuals (Introduction to R, Writing R
> extensions, ...).
>
> Philippe
>
> > Moreover, a number of these examples would also be relevant within the Snippets sections.
> >
> > For example:
> >
> > matrixcomp <- function(T,n){
> >               if (n==1) return(T)
> >               else return(matrixcom(T, n-1) %*% T)
> > }
> >
> > 1. Could be an example within the '%*%' help file.
> > 2. Could be a simple example of recursion in R.
> >
> > And being editable, would allow users to refine and improve the examples.
> >
> > My $.02
> >
> > Damian
> >
> >
> >>>>May be am I a little bit behind here, but I don't think the idea is to
> >>>>put *everything* in the Wiki. We want to put only what can be modified
> >>>>by R users. The only exception, currently, is the 'R documentation',
> >>>>alias the .Rd files that will be read-only, but with a discussion
> >>>>section at the end that will be editable. The Wiki is a *complement* to
> >>>>other resources, not a *replacement*, isn't it?
> >>>>
> >>>>Otherwise, there is no technical barriers to put also the manuals (as
> >>>>read-only) on the Wiki. Same remark for package vignettes.
> >>>>
> >>>>Best,
> >>>>
> >>>>Philippe Grosjean
> >>>>
> >>>>_______________________________________________
> >>>>R-sig-wiki mailing list
> >>>>R-sig-wiki at r-project.org
> >>>>https://stat.ethz.ch/mailman/listinfo/r-sig-wiki
> >
> >
> >
> >
>
> _______________________________________________
> R-sig-wiki mailing list
> R-sig-wiki at r-project.org
> https://stat.ethz.ch/mailman/listinfo/r-sig-wiki
>