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
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.
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.