Build the docs using sphinx

You can build the sphinx based docs from the project directory by running:

$ tox -e docs

This will build the static docs on the docs directory, which includes API docs that pull in docstrings from the code.

See also

Documentation Standards

The docs will be built into the build/html directory, and can be opened locally with a web browse:

$ firefox build/html/index.html

Autobuild

You can also run an autobuild process, which will watch your docs directory for changes and rebuild whenever it sees changes, reloading any browsers watching the pages:

$ tox -e docs autobuild

You can view the pages at localhost:

$ firefox http://localhost:8000

If you are making changes to source code too, you can tell it to watch changes in this directory too:

$ tox -e docs autobuild -- --watch src