Editing This Documentation

Building the Docs

From the docs directory, execute the following command to rebuild all editted pages:

make html

To rebuild all pages, you may want to do a clean build:

make clean && make html

Viewing the Docs Locally

From the docs directory, open the index file from the build directory with the command:

open _build/html/index.html

Editing the Docs

All Django modules are documented via Sphinx AutoDoc. To edit this documentation, update the docstrings on the relevant functions/classes.

To update the handwritten docs, edit the relevant .rst files which are included by filename from index.rst.

Note

Be sure no warnings or errors are printed as output during the build process. Travis will build these docs and the build will fail on error.