Improve doc strings

[kmax12]

Now that the new docs are up, it makes sense to go through and clean up the doc strings for all the methods.

Notes:

• Can we document methods on the base class and have the doc strings show up for subclasses in sphinx?
• Can we add usage examples in doc string i.e doctest?
• How can we document methods on subclass that are not defined?