DocBook docs

Emma Jane Hogbin emmajane at xtrinsic.com
Mon Dec 17 05:53:13 UTC 2007


Good morning,

I've been poking around on the new wikified style guide pages. Thanks 
for breaking it up, Phil!

I found these two pages on DocBook:
https://help.ubuntu.com/community/DocBook
https://help.ubuntu.com/community/DocBookReference?highlight=%28%28DocBook%29%29

Apart from the license being wrong for the style guide, is there a 
reason why this information shouldn't be incorporated into the Style 
Guide/DocBook page at:
https://wiki.ubuntu.com/DocumentationTeam/StyleGuide/DocbookConventions

The first of those two pages on DocBook needs some editing as well--and 
depending on the context of the document a re-think about the depth of 
information to provide. Within the seven pages of information readers 
jump from XML markup languages to shell scripting to style sheets and 
transformations and needing a local web server configured (I don't 
*think* Apache is installed by default, is it?). That's a LOT to absorb 
all in one page.


regards,
emma

-- 
Emma Jane Hogbin, B.Sc.
Founder, xtrinsic
phone: (519) 371-2665
web: www.xtrinsic.com




More information about the ubuntu-doc mailing list