Updated README.
Updated docstrings to help out the end-users!
Merge branch 'hotfix-readme'.

Updated the README.rst and added docstrings to main classes.
Mostly just a hotfix test for my own experience using git-flow.