Edubuntu documentation project now in Ubuntu Documentation svn

Jerome Gotangco jgotangco at gmail.com
Thu Jun 16 03:41:31 UTC 2005


> AFAIK, some guys from the ubuntu gang are working on a Moin-DocBook
> parser which will be great because all we wiki could be "easily"
> transformed into DocBook.

Yes, but its very much WIP at the moment. Like I said before, this
should be our long term goal with regards to collaborative authoring.

> DocBook is great but not when coordinating many people working at the
> same time on the same docs and needing peer-reviewing, beacuse then
> you get forced to a SVN, while when using Moin, we all get notifed,
> can read, see changes, see diff, get statistics, revert, use ACL's,
> have templates, etc.

Yes, we've already seen the advantages of wiki-based authoring. But to
get up to speed in-time for Breezy release, the DocBook method is tried
and tested and will give results right now. The biggest issues with the
DocBook and SVN method are 1) knowledge of Docbook itself; 2) Giving
commit accounts to svn and having people use it.

The wiki is a great place to harvest documentation when properly
seeded/written; that's what we've recognized in our current wiki

> Anyways, i am a simple translator and interpreter, and probably have
> worked on less collaborative documentations processes than you all, so
> whatever you decide it is best choice, that I will try to use.

We're trying to make sure i18n documentation for Ubuntu will be done in
Rosetta (We've tested some in time for Hoary). The first method was have
the translators submit the PO files to the documentation team and we'll
commit them, but sadly, it was not as successful as we had planned.

Anyways, I usually lurk in #ubuntu-devel and #ubuntu-doc in freenode, so
in case there are issues we have to talk about, i'm there but my
timezone is UTC +8.

Cheers!

Jerome Gotangco





More information about the edubuntu-devel mailing list