Documenting RASCIL

• The primary documentation is written in reStructuredText (rst).

• We use Sphinx to extract code documentation.

• We use the package sphinx_automodapi to build the API informatiom.

• For this to work, all of the code must be loadable into python. To facilitate this, we make use of the dreaded from somewhere import *. This means that modules must use __all__ to only export those names that are delivered by that module, as opposed to the other names used in the module.