Improved docstrings.
Merge pull request #1 from ajdawson/docstring-update

Improved docstrings.