Meta-docs (docs about the docs)

These docs are generated using sphinx

All code in the documentation doubles as doctests, so it is guaranteed to run correctly. In addition, since the API docs (API) include docstrings from the source code itself, these tests are run as well when the documentation is generated.

Building the docs

  • Install the requirements from the dev-requirements.txt file in the top dir of the repo:

    $ pip install -r dev-requirements.txt
    
  • Navigate to the doc folder in the source.

  • Run doctests:

    $ make doctest
    
  • Build HTML. The results are in doc/build/html/:

    $ make html