Go through scripts and give each function a sphinx readable description and unit tests

[Islast]

sphinx auto creates documentation from the description given within your function. The benefit to this is that you can update the docs in the same place that you change the code.
This is already done for many functions due to Kirstie's forsight 💖

[Islast]

An example of how this tool can be used https://pythonhosted.org/an_example_pypi_project/sphinx.html

[Islast]

sphinx documentation setup tool that is extremely useful : http://www.sphinx-doc.org/en/stable/man/sphinx-apidoc.html

[Islast]

Progress on this issue taking place on this branch
http://www.sphinx-doc.org/en/stable/man/sphinx-apidoc.html

[Islast]

closed in #78