Clean up source code documentation

* Removed method descriptions from the class docstring and put them into the respective method docstrings.
* Added an extra line between docstrings and the `pass` statements.
* Misc. documentation clarification.