flesh out readme
improve formatting and fix typos.
make minor improvements to clarity and formatting.
Merge pull request #11 from kdbanman/master

Improve documentation.