Sec: Unclassified - New contributions without docbook

Stoffers, Robert LAC Robert.Stoffers at
Tue Oct 18 02:35:35 UTC 2005

I'd just like to add an idea of mine to that if I may: what if we accepted new document contributions done on the Ubuntu wiki and "converted" them to docbook ourselves? Once the content and outline is done, all we need to do is add the appropriate tags to have a new document. This would negate the learning curve of docbook for new contributors, this way we get the advantage of easy-to-learn Moin and still keep our existing setup. We might even be able to write a script to do the "conversion" if someone is keen.

We wouldn't accept every proposal of cause, and would require people send their proposal to this mailing list first for discussion. I also remember TLDP having an online docbook document editor page on their website that could also be of use. 


Robert Stoffers
Author/Maintainer - Ubuntu FAQ Guide
Email - rstoffers at

-----Original Message-----
From: ubuntu-doc-bounces at
[mailto:ubuntu-doc-bounces at]On Behalf Of Jerome Gotangco
Sent: Tuesday, 18 October 2005 11:40
To: ubuntu-doc at
Subject: Re: proposal for our repository structure post-breezy

> Can the gnome-doc build be used for Kubuntu-docs as well? I would love to get
> these into Rosetta as well so we can get those translated as well.

Yes it can be used as well since we work in source format. I'll be
doing a lot of Kubuntu stuff for dapper definitely, so we'll think of
a plan :)

I still give my vote to work in svn as it has proven to work for us;
the problem we currently have is how the trunk is structured when it
gets branched for release, not svn itself, although moving to a
distributed system is ideal, we'll need the help of the baz people
like James Black for the transition (he volunteered to help out). For
Dapper, I'd still want to work on svn, but also grab the opportunity
to learn more about baz/baz-ng and start the transition for 6.10 (the
tools would be more mature then).

While Moin is extremely configurable with documentation work and
access control, the Ubuntu wiki is not something we have direct
control over it. When I say control, I mean ACLs and Admin rights.
It's possible with a little scripting to lock pages by a select people
but that would mean James (Troup) and/or Henrik (Omma) to cofigure the
whole Ubuntu wiki for it.

Going to the Moin route can definitely break the contributor barrier
but at the same time, goes astray to the general route of Ubuntu
development - which is distributed version control.

Jerome Gotangco
jgotangco at | jgotangco at
GPG: 0xA97B69A0

ubuntu-doc mailing list
ubuntu-doc at

More information about the ubuntu-doc mailing list