Issue #28. Improved README and code documentation

Fixes #28.
Issue #28. Reworded sections for consistency
Issue #28. Restoring accidentally deleted code
Merge pull request #43 from jasonrydberg/28-documentation

Issue #28. Documentation