Expand documentation

This PR just expands on the existing documentation in the README. It adds two things:

1. A more complete example of using heroku-deploy with `run` commands.
2. A trouble shooting section, which would have helped me resolve https://github.com/wercker/step-heroku-deploy/issues/10 much faster.