Create API docs from the docstrings properly

[tleeuwenburg]

I have gone through and greatly improved the module and method docstrings. It would be fantastic if someone could go to the trouble of setting up some automagical way of getting this all into the docs directory using some sphinx automation. Ideally, this should auto-update on commit, too.