[wp-docs] DocBook, anyone?

[Matt Mullenweg]

I think XHTML is a very good format for what we're doing. It's easy to 
author and easy enough to transform into something else if we need to.

Ryan J. Markel wrote:

> 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
> 
> 
> _______________________________________________
> docs mailing list
> docs at wordpress.org
> http://wordpress.org/mailman/listinfo/docs_wordpress.org


-- 
--Matt
http://photomatt.net | http://wordpress.org