Updated package docstrings.

Consistent use of sphinx referencing and more complete docstrings.