Welcome to TechWhirl Forums

Sign in or Register to get involved in our discussions.


Semantic docs - DocBook vs. Sphinx

LenaLena Czech RepublicPosts: 1
Dear colleagues,
I'm in a rare position where I'm designing a new "documentation system". While I'm sure that I want to use the single-sourcing principle and semantic mark-up, I got stuck at choosing a particular format.
The dilemma is to choose between DocBook 5 (XML) and reStructuredText with Sphinx extensions (lightweight wiki-like mark-up). Both formats provide more-or-less the same features and both are supported by free open-source tools. I tried to consult this with my colleagues but nobody has a strong opinion in any direction.
Do you have any experience with these formats? I would be grateful for your opinions on the pros and cons or suggestions upon which criteria to weigh my decision.
Thank you for reading.
Sign In or Register to comment.