Re: Wiki user guide

[Shaun McCance <shaunm gnome org>]

On Wed, 2006-07-05 at 23:26 +0100, Joachim Noreiko wrote:
> --- Shaun McCance <shaunm gnome org> wrote:
> 
> > On Wed, 2006-07-05 at 23:02 +0100, Joachim Noreiko
> > wrote:
> > > (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.
> <snip> 
> > It is coming.  I promise.
> 
> That's fantastic news! :)
> 
> I was talking to some of the Ubuntu guys recently, and
> it occurred to me how Mallard could mean our User
> Guide and Ubuntu's User Guide (which mostly cover
> different things) could seamlessly integrate... 
> I'll jot some thoughts down on the wiki page later.

That is exactly the intention.  The goal is that we can
have a single core User Guide.  Users won't have to look
at two guides and ask themselves if it's a Gnome issue
or an Ubuntu issue (or a Fedora issue, or a Novell issue,
or a Solaris issue, or whatever).

Our User Guide would provide all the information that
we're capable of providing.  And it would provide the
outline for vendors to plug in the information they can
provide.  The end is a coherent user-oriented document
composed of topics coming from two different places.

This same functionality can also be incredibly useful
for programs that make use of plug-ins or add-ons.

Documentation will be easier to write, easier to read,
and easier to manage.  Everybody wins, because that's
the kind of good-hearted sporting guy I am.

--
Shaun