Hi all,
I'd like to discuss using Sphinx (http://sphinx-doc.org) for the Mesos
documentation.
Pros:
- you can generate HTML docs, PDF, single-page HTML
- you can generate man-pages for the user commands
- there's more markup
- supports indexing, cross-referencing and simple searching
- you can your own markup for cross-referencing and formatting
- it is easy to publish multiple version on readthedocs.org
Cons:
- not sure how the website integration would work
- there's more markup (more docs syntax to learn)
If there's interest (and a shepherd), then I'm willing to do the conversion.
cheers,
James
