Currently, our various classes are described in the documentation via explicit .. class .. method directives. We should move to autodoc, and move these docstrings inline.

This will reduce the duplication, and make it difficult for the documentation to be out-of-sync with the code.