Guidelines for writing?

[Nick Loeve]

Hello,

> 
> I see the possibility of having a package for ubuntu documentation
> people ("docteam-tools" or something alike) which installs a guideline
> document (on which I could work with Matt, if Matt agrees) and various
> docbook templates (on which I could work with Nick, if Nick agrees.
> 
> Matt, Nick: if you agree, I can create and post a skeleton package and
> then we can fill it up together.

Yep. I would love to help out. I am currently trying to do some stuff
for the usersguide, and work is really heavy at the moment, but as long
as the deadline isn't too tight, this sounds like a great idea!

> 
> 
> > So for an example...
> > If we have the xml entity '&gnuubuntu;' to used in the DocBook source,
> > the when we transform the DocBook source into wiki markup, it maybe be
> > output as the term 'Ubuntu GNU/Linux' wrapped in a link to what
> > reference means in terms of context. For this case it would be the open
> > source attributes and concepts at work in Ubuntu.
> 
> This is interesting, but it would open some problems when one
> concurrently updates both the DocBook and the Wiki, and then this
> automatic conversion happens and the wiki changes get lost.

Yep. Point taken. Maybe later this processes could be laid out a little
better (i pretty much blurted that off the top of my head :) and there
could be some tight controls to stop that happening.

Cheers,
;) trickie