Re: [Chicken-users] Wiki (early) spring cleaning!

[felix winkelmann]

On Sat, Feb 28, 2009 at 8:48 PM, Peter Bex <address@hidden> wrote:

> The cleanup I'm suggesting does not necessarily have to be major, the
> immediate proposal of this mail is simply to move all the eggdocs to
> a new subdirectory eggref/3, to match eggref/4 and also to match the
> egg structure; eggref/X/Y  will be the documentation for  release/X/Y.

Yes, we should move the egg docs into eggref/3. Actually "release/3"
would probably have nicely matched with the svn branch names, but
this is not too  important.

>
> There's another reason the current layout is problematic.  Currently,
> when you surf to http://chicken.wiki.br/wmiirc, for example, you get
> the Chicken 3 documentation for the wmiirc egg (as you can see by the
> prefixed identifiers).  However, wmiirc has been ported to Chicken 4,
> so the moment that Chicken 4 is released, it would make more sense to
> have that URL point to the documentation for the current release;
> http://chicken.wiki.br/eggref/4/wmiirc
> But I would still like the old documentation to be available.  This
> would require moving the '3' docs, because the redirect would make the
> old docs inaccessible.

Alternatively, svnwiki could provide a disambiguation page, where
different versions are presented (somewhat like wikipedia, I guess).

>
> So, what do you think?  Is this a good idea, or am I overlooking
> anything important?  Will it break stuff horribly?

Only a few links will break. It's important to clean up the wiki dir (and
if you'd give us a hand doing this, I'd greatly appreciate it). What has then
to be fixed ias the Egg-index (and thus egg-post-commit (shudder!)).

I'm currently discussing this with Ivan and Mario (in the process of
planning the next release), perhaps you should get involved.


cheers,
felix