How To - Project Documentation

Get Started

Documentation can be written as rst files in re-sharing/docs.

To build and serve docs, use the command:

make livehtml

from inside the re-sharing/docs directory.

Changes to files in docs/_source will be picked up and reloaded automatically.

Sphinx is the tool used to build documentation.

Docstrings to Documentation

The sphinx extension apidoc is used to automatically document code using signatures and docstrings.

Numpy or Google style docstrings will be picked up from project files and available for documentation. See the Napoleon extension for details.

For an in-use example, see the page source for Users.

To compile all docstrings automatically into documentation source files, use the command:

make apidocs