[R-wiki] Top level organization

[Martin Maechler]

>>>>> "PhGr" == Philippe Grosjean <phgrosjean at sciviews.org>
>>>>>     on Sat, 04 Feb 2006 08:17:38 +0100 writes:

    PhGr> Gabor Grothendieck wrote:
    >> On 2/3/06, Ben Bolker <bolker at zoo.ufl.edu> wrote:
    >> 
    >>> Gabor Grothendieck wrote:
    >>> 
    >>>> This is looking very good.
    >>> 
    >>> definitely agree.  I think we may eventually want
    >>> to tweak the categories in Tips&tricks, but we're getting
    >>> to the point now where we'll need to let some material
    >>> accumulate before we can really decide on the best
    >>> arrangement.
    >>> 
    >>> A few comments:
    >>> 
    >>>> - what is the difference among Manuals, Cookbooks and Tips and Tricks.
    >>>> Its not clear to me.
    >>> 
    >>> 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"
    >> 
    >> 
    >> 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.

    PhGr> No, there is no plan to wikify the official R manuals (just a link to 
    PhGr> their PDF version on CRAN).

why that?  All the official R manuals (apart from the
"reference", i.e. the help pages) are written in *.texi
(texinfo) which then are translated to latex and pdf, but also
to HTML (and to Emacs info).  Why not link to the HTML versions
of the official manuals, or maybe even "wikify" the HTML version
(but the "wikification" should setup in a way to be updatable
 with every new release of R).


    PhGr>  There will be only a wikified version of the 
    PhGr> online help on R functions (in the R documentation section). This serves 
    PhGr> two purposes:

    .............


Martin Maechler, ETH Zurich