Add docstrings for non-trivial methods and classes

[enioluwas]

The code is not properly documented in most cases. We need to add docstrings for many of the complex methods and classes e.g

"""
This method does complex stuff.
"""
def doComplexStuff(self, thing):
    pass