docs(readme): remove cruft and add clarifications
Merge pull request #1069 from deis/readme-fixes

docs(readme): remove cruft and add clarifications