Some Sphinx autodoc compatible docstrings

Created by: bjackman

Some docstrings I wrote on the train. I'll submit infrastructure to actually build this in the future.

I also got halfway through documenting Executor but it's still rather messy so I'll try to get round to submitting it properly.