[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