I'm not sure how much DocBook gains us. I can see the following benefits: - easy conversion to non-html formats (like print) - conformaty with other open-source projects.
Besides that, I don't see the advantage over XHTML. If I were to imagine the ultimate format, it would be XML that was specifically structured for our needs. For example, a module doc could look like <module> <module-name>mod_access</module_name> <module-source-name>mod_access.c</module_name> <summary>blah blah</summary> <directive> <directive-name>Allow</directive-name> <directive-syntax>blah blah</directive> ... </directive> ... </module> (I make no claim that this is actually XML.)
