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. It uses Cache-Control with a long max-age, to take advantage of the Varnish http cache which fronts all Heroku apps. 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...