[R-wiki] Top level organization

[Philippe Grosjean]

Ben Bolker wrote:
> Gabor Grothendieck wrote:
> 
> 
>>>[GG]
>>>A few comments:
>>>
>>>
>>>>- what is the difference among Manuals, Cookbooks and Tips and Tricks.
>>>>Its not clear to me.
>>>
>>> [BB]
>>>  Manuals and "cookbooks" are longer and by a single or a few authors;
>>>tips and tricks are shorter and more collaborative (I've tried to
>>>clarify a little bit by adding a few short descriptions to
>>>"start2").  That said, I think the subdivision within "Guides"
>>
>>[GG]
>>This is still not clear..  There are THREE categories currently,
>>not two.  The three possible categories I can see are:
>>
>>- official R manuals.  The official manuals that come with R wifieid.
>>- other R documents.  Contributions from users.
>>- snippets.  Paul Johnson's collection, etc.
>>
>>Is that the distinction?  Should it be?
>>
> 
> 
> Are you looking at http://www.sciviews.org/_rgui/wiki/doku.php?id=start2
> ?   it has "Getting Started", "Guides", "Tips & Tricks", "R Packages",
> "R Documentation", "Links", "Miscellaneous".
>    I would say "R Documentation" = your category #1
>                "Guides" = your category #2
>                "Tips & Tricks" = your category #3
> 
>    I like this set of categories and (for the most part) names for them.
> 
>    I can imagine arguing some more about the proper name for Tips&Tricks 
> (=  Snippets = Short examples & notes = Rtips and other stuff = Code
> library = Shorter material = ... ?); I can also imagine that "R 
> Packages" needs some clarification (what's in here? notes on R packages?
> Wikified documentation -- or is that in "R Documentation", which claims
> to have help for all of CRAN and Bioconductor?)
> 
>    Ben

About R packages: very simple! You have one section per package on CRAN 
and Bioconductor. Inside each section (i.e., package), you have at least 
one page, which is automatically generated and is roughly similar to the 
  equivalent page on CRAN (see 
http://www.sciviews.org/_rgui/wiki/doku.php?id=packages:cran:pastecs for 
an example).
The rest of the content is *totally free* and is the responsability of 
packages authors/maintainers. The idea is just to stimulate addition of 
material in a centralized place, a kind of "farm of home pages for R 
package".
So, appart from the automatic generation and update of one page, we 
don't have to worry about the rest of that section. It is out-of-scope 
for us, it is in the maintainer's namespace (to speak S language).

Best,

Philippe Grosjean