Various consistency updates in documentation.

- Consistent docblock formats
- Standardize on Sphinx param formatting
- Word wrap super long lines in README and LICENSE
- Add some missing doc blocks
- Add TODO items where doc blocks need explanation
- Simplify some wording
- Remove a few needless blank lines
- Fix some minor comment formatting (PEP8 consistency)