Ubuntu Style Guide

[Matthew East]

* Simon:
> On 5/26/07, Rich Johnson <nixternal at ubuntu.com> wrote:
>> 4) Convert this documentation into a wiki page instead or is it better being
>> left as is?
> 
> You just gave me an idea that I could have thought of earlier, but
> didn't: write a wiki that uses docbook xml as the source markup for
> each page.  It would be advantageous in that it would be easier for
> users to make contributions that could be merged from the wiki into
> the official documentation.  I'm not trying to convince anyone to do
> this, just sharing the idea on the odd chance that someone else will
> like it.

Don't worry - someone has thought of this!
http://doc-book.sourceforge.net/homepage/

More importantly, see http://moinmoin.wikiwikiweb.de/DocBook for the
state of docbook support in our wiki software.

It would indeed be *very* useful to be able to merge documents quickly
from the wiki to the system documentation and vice versa. I would really
like to get our wiki work and system documentation closer together - in
particular I'd like to see the "official" documents merged into the wiki
so that we don't make the confusing distinction between "official" and
"quasi-official" on the website any more. The tools for docbook<->moin
are more or less available (on top of the work done with MoinMoin at the
link above, there is some docbook->moin xslt in our repository), but
what we really need to work on is a way to properly integrate the
"official" docs into the wiki.

For that I think we need to develop the
https://wiki.ubuntu.com/HelpWikiQualityAssurance specification.

Matt

-- 
http://www.mdke.org
gnupg pub 1024D/0E6B06FF

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 252 bytes
Desc: OpenPGP digital signature
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20070527/7135572e/attachment.pgp>