Direction of the Ubuntu system docs

[Phil Bull]

Hi Jim,

On Sat, 2011-01-01 at 14:03 -0600, Jim Campbell wrote:
[...]
> I would concur that option #1 seems like the most viable option at
> this time.  
> 
> With regards to being able to use some portions of the Gnome user help
> (which would require review and appropriate modifications), I wouldn't
> see that as very practical for this release.  The Gnome team is still
> in the process of updating their docs for Gnome 3, and much work
> remains to be done. W

Very true. I think we'll be able to get most of the GNOME Desktop Help
done before the GNOME 3.0 release, though. The great thing with Mallard
is that we can just cherry-pick the finished topics from the Desktop
Help and they'll plug-in seamlessly. No nasty patches - we just include
the right files. If we write the Ubuntu docs in Mallard, it'll be
trivial to restructure them as the GNOME docs get more complete, so I
think it would be a reasonably practical solution even for this cycle.

> Using Mallard would allow us to easily plug-in modified portions of
> Gnome user help where appropriate, but there is no Mallard output to
> PDF, so Mallard wouldn't be a good choice for the server guide.

I agree. Converting the Server Guide to Mallard would also be quite a
big job. It should probably stay in DocBook for now - I don't think we'd
gain much by converting it.

> I propose a meeting within the next week to decide between our
> options.  Would next Saturday or Sunday work?  If so, please note that
> times that you're available to meet:
> 
> http://www.doodle.com/n9bqwm2c56nbqd8y
> 
> I'll also update the wiki with information about the meeting.
> 
> https://wiki.ubuntu.com/DocumentationTeam/MeetingAgenda

Awesome, thanks Jim!

Phil

-- 
Phil Bull
https://launchpad.net/~philbull
Book - http://nostarch.com/ubuntu4.htm