Re: Wiki user guide

[Shaun McCance <shaunm gnome org>]

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.

--
Shaun