Fork Our Docs

Heroku is now sporting an updated docs layout at 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...

Read more →

Browse the blog archives, subscribe to the full-text feed, or visit the engineering blog.