fix #1 - streamline docs and setup for contributors

* Replaced a bunch of content with links to content elsewhere
* Fixed a couple of snags I hit while installing/deploying
* Replaced all the heroku docs with an `app.json` and a [Heroku button](https://devcenter.heroku.com/articles/heroku-button).