httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rich Bowen <>
Subject Docbook and other doc formats
Date Tue, 17 Jun 2014 15:44:23 GMT
Long, long ago, we did the arduous conversion from HTML to XML for our 
documentation format, and the benefit was enormous and immediate - well 
worth the effort.

Now, ten years later (at least) Docbook/XML is no longer quite as 
popular as it once was, and I wonder to what extent it is stifling 
contribution to the documentation process - in particular, translation. 
At the moment we have *one* translation (French) which is maintained, 
and everything else is woefully behind. See I 
wonder if it's because the initial setup to translate a document is just 
so big.

And so I was wondering, if the time has come to consider moving to 
another format, or, perhaps inserting another format into the existing 
toolchain. eg., using Pandoc ( or 
similar to go Markdown -> Docbook and then from there use our current 
toolchain. Or possibly convert entirely to Markdown (or asciidoc - or rst - and build a new conversion chain.

While the initial effort to make this move would be substantial, I feel 
that the benefits would be enormous in terms of getting new 
contributors, and new translators, for the documentation effort.


Rich Bowen - - @rbowen - @apachecon

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message