Fix sphinx style issues from docstrings

I found some problems generating documentation and have found some style issues using this [sphinx plugin for flake8](https://github.com/peterjc/flake8-rst-docstrings).