All posts tagged with docs opensource

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...

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