[R-wiki] tips formats

[Gabor Grothendieck]

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

I generally prefer the long pages since its a pain to have navigate
all the short pages and one can use ctrl-F to find what they are
looking for.