Refactor: rewrite docstrings and some methods

Added detailed docstrings to every class and method.
Also rewrote some methods, added more robust exception handling,
some helper methods, and a few more minor changes that can be seen
in the diff.

Author: raycadle