Heroku is now sporting an updated docs layout at docs.heroku.com. These new docs should be much easier to navigate and link to.
We built this as a standalone Sinatra app serving Markdown files, partially inspired by Assaf Arkin’s approach to Buildr. This makes it as snappy as staticly rendered pages, while retaining the flexibility of a dynamic app on the backend.
The docs app is deployed as a regular app on Heroku (just like this blog). Nothing special-case here: we deploy with git push, just like any other Heroku user. Dogfooding is good for you.
The app’s source is on Github. Fork and send us a pull request if you want to make edits to improve the wording, fix a typo, or...