Add docstrings to every function. And a few other comments.

Signed-off-by: Zack Cerza <zack.cerza@inktank.com>
Fix param docstring format to be more Sphinx-y

Signed-off-by: Zack Cerza <zack.cerza@inktank.com>
Fix some PEP-8 issues

Signed-off-by: Zack Cerza <zack.cerza@inktank.com>