Update readme.md

Updating the docs and fleshing them out further.