Sphinx-HTTP-domain

Documentation Utilities (aka Docutils): http://docutils.sourceforge.net/. Allows reStructuredText markup, programming of custom "roles" and "directives", HTML and PDF creation Sphinx Doc: http://www.sphinx-doc.org/en/stable/. Builds on top of Docutils. Allows API documentation (http://www.sphinx-doc.org/en/stable/ext/autodoc.html) and cross-documentation linking via intersphinx (http://www.sphinx-doc.org/en/stable/ext/intersphinx.html). epub, PDF, and html output. I've created mini technical manuals at previous workplaces using sphinx. More clickables: For graphs, grab aafig: https://pythonhosted.org/sphinxcontrib-aafig/ or graphviz http://www.sphinx-doc.org/en/stable/ext/graphviz.html For enhanced python documentation (numpy and google style api docs) http://www.sphinx-doc.org/en/stable/ext/napoleon.html For creating your own API docs o

Well, here's a cool plugin I've been using lately: https://github.com/deceze/Sphinx-HTTP-domain For documenting code, Sphinx has the advantage that you can use it for cool stuff like testing the sample code provided. See here: http://sphinx.pocoo.org/ext/doctest.html But you won't get away with just docstrings. Good documentation also includes a high-level overview of the API, history of changes, a glossary of terms, etc... It does have a slight learning curve, but it is very extensible while providing enough out-of-the-box already, and some people have been using it to write entire books.