Update readme.md

Updating the docs and fleshing them out further.
Merge pull request #27 from glennblock/dev

Update readme.md