Using Sphinx to produce the documentation
The Sphinx tool produces very good-looking documentation in a variety of formats. It can easily combine documentation from source code as well as external files with additional design notes, requirements, or background.
The Sphinx tool can be found at http://sphinx-doc.org. The download can become complex because Sphinx depends on several other projects. It may be easier to first install setuptools, which includes the easy_install script, and then use this to install Sphinx. This can help us with the details of tracking down the additional projects that must be installed first.
See https://pypi.python.org/pypi/setuptools for help on setuptools.
Some developers prefer to use pip for this kind of installation. See https://pypi.python.org/pypi/pip for information on pip.
The Sphinx tutorial is outstanding. Start there and be sure that you can use sphinx-quickstart and sphinx-build. Often, running sphinx-build is handled via the make program, which slightly...
