[R-wiki] Top level organization

[Gabor Grothendieck]

On 2/4/06, Philippe Grosjean <phgrosjean at sciviews.org> wrote:
> 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).

It would be nice if all the DESCRIPTION fields were on the auto-generated
home page, particularly the URL field, if present.