Publishing good wiki docs in the distribution

[Matt Galvin]

On 1/23/06, Jerome Gotangco <jgotangco at gmail.com> wrote:
> Having those docs would be nice but by doing that, you'll have to

I do also think this is a great idea, but...

> a) Freeze that wiki page at some point in time. You wouldn't want
> people looking at your document in the distro then refer to the wiki
> page of the same topic but finds out that the wiki page gives out
> different intructions.

This is also my concern. This is the only strong issue I see that
needs to be solved since the others are technical and can be dealt
with.

We may need to lock the wiki pages that are in the distro or possibly
move them off the wiki, into svn, and onto h.u.c or d.u.c. This is
just a possible solution.

> b) Clean up the xml generated by the wiki tool so it can be properly
> read by Yelp.
>
> c) Create scrollkeeper entries to register and show the new docs and
> probably even add a new category in sk itself.
>
> This is actually not complicated but can take some time.

It can be time consuming... but if we can come with some good tools to
manage the process than it could be much less painful.

Matt G.

--
Matt T. Galvin
http://www.simplifiedcomplexity.com/
GPG: 0x01403A57