Make sure we use a good way to create the python documentation

[johann-petrak]

Note of a number of resources which may be helpful:

• https://gisellezeno.com/tutorials/sphinx-for-python-documentation.html
• check if we want to use numpy-style documentation?
• Sphinx docu itself:
  • http://www.sphinx-doc.org/en/stable/ext/example_numpy.html#example-numpy
  • http://www.sphinx-doc.org/en/master/theming.html#builtin-themes
  • http://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_theme
• https://pythonhosted.org/an_example_pypi_project/sphinx.html

[johann-petrak]

The way we do this now seems sufficient.