Update readme.md

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

Update readme.md
Merge pull request #28 from WebApiContrib/dev

Dev