Allow site url to be explicitly set. Add high level comments.
Update Heroku related documentation.