[R-wiki] tips formats

[Philippe Grosjean]

Ben Bolker wrote:
>    a question for the list:
> 
>    comparing the format of
> 
> 1. http://wiki.r-project.org/rwiki/doku.php?id=tips:data-vectors
> 
> (all subtopics within the page as level-2 headers, index at top
> points to anchors within the page)
> 
> and
> 
> 2. http://wiki.r-project.org/rwiki/doku.php?id=tips:data-matrices
> 
> (subtopics as links to separate pages)
> 
>    which do people prefer/think is better? I think I prefer #1
> (it's closer to Rtips, broader rather than deeper, and facilitates
> browsing), but I'd like suggestions before I go and reformat
> the rest of the tips:data sections (matrices, frames, io, lists,
> manip, and misc have subpages now).
> 
>    Unless someone wants to write a script that will do the conversion?
> It would probably only take a few lines of Perl ...
> 
>    Ben Bolker


Wiki pages are rather free. So, something in between those two is 
acceptable. However, 
http://wiki.r-project.org/rwiki/doku.php?id=tips:data-vectors is *not* a 
good idea! Tips should remain short pages. Here you tend to write long 
pages, and noly one page per Wiki namespace in the tips section. This 
brings an additional overload to the server which has to deliver all the 
page everytime, even if people are looking for a specific section in 
that page. So, 
http://wiki.r-project.org/rwiki/doku.php?id=tips:data-matrices 
(subtopics as links to separate pages) is the appropriate format.

Note also that I have added a new plugin to *automatically* generate the 
index of a given Wiki namespace. This means that you don't need to 
manually edit tips:data-matrices everytime you add a tip there (i.e., a 
*separate* page)! I will show you an example, but not before next 
week... Too much urgent work this week.
Best,

Philippe Grosjean