[wp-docs] DocBook, anyone?

Ryan J. Markel markel at strategema.net
Thu Apr 15 10:45:27 CDT 2004


All right.

I'm not sure about the wisdom of going ahead and proposing this, but I 
would like to get some feedback about collating the documentation 
project for WP into a single, unified DocBook.

I am slowly going about the learning process for creating and parsing 
an XML-based DocBook document, but it's pretty slow at this point - the 
learning curve is a little greater than I was led to believe by people 
I know who've used it.

Is there anyone here who has experience with DocBook as a DTD?  Or has 
this been brought up before and ended up torpedoed?

DocBook has a lot going for it in the organization of information 
category, as well as ease-of-reading.  It's pretty straightforward, 
collates the docs into a nice hierarchy if written properly, and isn't 
as circular as the wiki - though I I realize this would leave the wiki 
in a weird sort of limbo.

It's my suggestion as a source of official documentation.

"Shots fired!  Shots fired!"

--markel
markel at strategema.net




More information about the docs mailing list