Tero's blog

Random notes

Documentation using Sphinx

I recently converted Ahven's DocBook documentation to use Sphinx and reStructuredText.

I did this to make it simpler to write documentation. reStructuredText is almost like plain text, so in theory it should be easier than XML-based DocBook.

As an unfortunate side-effect, this change introduces Python dependency to the project, while on the other hand, I get rid of Java-based XSLT tool dependencies.


Copyright © 2011 Tero Koskinen - Theme Skeleton; Blogging engine Pelican; Powered by Python