Revises documentation. Adds comments through code. Revises docstrings.
Update README.md

Display nicer on github
Merge branch 'feature/docUpdates' into develop