write class and method docstrings

[Schmoho]

Looking over the javadocs #116 revealed that we have a distinct lack of docstrings in the code base.

All classes, public constructors and public methods should carry a docstring.