Improved docstrings.

Simplified sphinx references, corrected typos, and improved wording.