[R-wiki] R Wiki structure - level 1 & start page

[Roger Bivand]

On Thu, 2 Feb 2006, Philippe Grosjean wrote:

> OK, let's proceed step-by-step.
> 
> Do we agree with the top level structure of the wiki:
> 
> - beginners: collects together material for first time R users (and for 
> curious people wanting to discover what R is). Subsections must still be 
> defined.

Is it at all possible to use the CRAN Task Views to "view" packages and 
functionalities. I feel that Task Views are a potentially useful way of 
reflecting emerging clustering, and do - even for beginners - give a view 
of discipline or thematic groupings of functionality? Beginners in Finance 
arguably can benefit from a different view than say Ecology?

Just a thought.

Roger

> 
> - documentation: the wikified .Rd pages of all CRAN and Bioconductor 
> packages, one subsection per package. Automatic update of the pages; 
> free discussion at the end of each page.
> 
> - packages: one wiki page for each package on CRAN and Bioconductor 
> (subsections CRAN / Bioconductor + one page automatically generated for 
> each package). Package authors can add material there (wiki versions of 
> vignettes, todo lists, further examples, links to related resources, 
> etc.). This would be a kind of default package homepage, i.e., we will 
> advise to use it as default URL in the package description.
> 
> - snippets: this is a huge section to contain various short pages. We 
> have currently:
>    + tips: tips & tricks about R (please, do not comment yet on 
> subsections there). The template for this is Paul Johnson's Rtips + 
> James Wettenhall R Tcltk examples. It will also contain wikified 
> versions of interesting threads on R-Help
>    + cookbook/examples: (I wonded if we really need to make two 
> different sections here). Pages explaining from beginning to end how to 
> make a given analysis in R, examples in focused on practical application 
> of the method, cookbook is more "theoretical".
>    + faq: shouldn't it compete with the existing FAQ files on CRAN? The 
> advantage of the wiki version is that other people can easy add FAQs,... 
> but is it really an advantage?
>    + surprises: suggested by Tony Plate: a special location for tricky 
> stuff.
>    + notes: really a free section for consideration about R development, 
> R use, etc.
>    + easier: a collection of functions to ease R use. Could perhaps 
> become a collaborative r package on CRAN in the future.
> 
> - tutorials: typically, longer documents than in snippets: introductions 
> to R, tutorials, session demos, ...
> 
> - varia: anything that does not fit in the other sections. Ben proposed 
> "miscellaneous" instead, but (1) it is longer and (2) a section name 
> beginning with 'm' falls between the previous one in alphabetic order, 
> which is less satisfactory in the index. What about the idea of a 
> 'challenge' section there? (see 
> http://www.sciviews.org/_rgui/wiki/doku.php?id=varia:0_introduction)
> 
> - weblinks: related web resources.
> 
> - Wiki: all about the Wiki itself.
> 
> There is also a rather sober proposal for the 'start' page. Please, keep 
> in mind that the 'index' at left will be replaced with a sidebar 
> proposing direct links to various places of interest (a little bit like 
> the left part of http://wiki.tcl.tk/). Would you like to propose an 
> alternate 'start' page, feel free to do so by creating 'start2', 
> 'start3', etc...
> 
> Best,
> 
> Philippe Grosjean
> 
> _______________________________________________
> R-sig-wiki mailing list
> R-sig-wiki at r-project.org
> https://stat.ethz.ch/mailman/listinfo/r-sig-wiki
> 

-- 
Roger Bivand
Economic Geography Section, Department of Economics, Norwegian School of
Economics and Business Administration, Helleveien 30, N-5045 Bergen,
Norway. voice: +47 55 95 93 55; fax +47 55 95 95 43
e-mail: Roger.Bivand at nhh.no