cherry picked Armando's README.md reformatting
added a heroku deploy debug tip, and a few instructions for running the app locally to doc/README_FOR_APP.md