Merge pull request #5 from pellagic-puffbomb/develop

Minor changes to documentation and docstrings. Hopefully, some useful examples in README.
Merge branch 'develop'
Fixing typos, errors in README.md