Re: Wiki user guide

[karderio <karderio gmail com>]

Hi :o)

On Wed, 2006-07-05 at 17:14 -0500, Shaun McCance wrote:
> On Wed, 2006-07-05 at 23:02 +0100, Joachim Noreiko wrote:
> > --- karderio <karderio gmail com> wrote:
> > > Well, this seems somewhat similar to what we had
> > > already : an index that
> > > writers would add the content to, except that
> > > currently we don't have
> > > the actual index, but a new index that represents
> > > how things should be
> > > after reorganisation (at least that is the theory, I
> > > suppose).
> > 
> > Yeah...
> > the Desktop User Guide is such a monster of a thing
> > that it hurts my head to think of having two copies of
> > it on the wiki AND cvs.
> > (An aside to Shaun if he reads this: Project Mallard!
> > we need to dice the monster up into topic-sized
> > chunks!)
> 
> Yelp infrastructure should be in place within the next
> three months.  Once the 2.16 docs are out, I'd like to
> get any interested documentation writers to sit down
> with me and actually write some documentation in the
> new format, as we develop it.
> 
> I think you'll find the format pleasantly simple, but
> it will require you to think differently about content
> organization.  Fortunately (and unlike linear documents)
> content really can be written before we've made all the
> organizational decisions, and we can reorganize stuff
> with little to no impact on content.
> 
> It is coming.  I promise.

Cool :)

I must confess, I'm not sure exactly what this consists in, but the more
I understand it the cooler it seems :)

Does this replace docbook as <i>the format</i> ? If so, may we as well
invest in working on the wiki, as online docbook editors may not be so
useful ?

Love, Karderio