Re: [docbook-apps] Show off what you've done with Docbook

[Stefan Hinz <stefan.hinz@oracle.com>]

Hi,

> Have any of you PDF + HTML output with Docbook? If anyone has such a project and will be willing to show it off, send some URLs!

The MySQL documentation is created and maintained in DocBook XML. The 
entry point to the docs is here:

http://dev.mysql.com/doc/

As you can see, we build a lot of formats from DocBook, including Unix 
man pages which are created from the same source as the rest of the 
formats (most documentation teams maintain man pages separately).

Last time we cared to do a detailed analysis of our stuff was in 2009; 
here's a summary:

http://dev.mysql.com/doc/index-about.html

It's only become more in every respect, more products to cover, more 
books, more pages, more complexity. We get the "why don't you use X 
instead, it's so much better" question every once in a while, but 
DocBook has been working remarkably well for us for more than a decade, 
and it scales, so we have no plans to move away from it anytime soon.

Reasons to consider DocBook in the first place included Norm's 
(http://docbook.org/tdg/en/html/docbook.html) and Bob's 
(http://www.sagehill.net/docbookxsl/) great books, by the way. :-)

Cheers,

Stefan

--
Oracle <http://www.oracle.com>
Stefan Hinz, MySQL Documentation Manager
Oracle MySQL <http://dev.mysql.com/doc>
Berlin, Germany, +49-30-82702940