Clearly distinguish between routes

[kevinburke]

Each route should be clearly delineated (with the 2nd biggest heading on the page, or with an <hr> or something)

It would also be nice if each route had an English-readable summary of what it did, eg "POST /orders" creates a new order.

[ekampp]

You can already do this, consider this:

resource 'Documentation' do
  get '/', explanation: 'Some long explanation about what this does' do
    # expectations
  end
end

[ekampp]

And if you override the styles.css file and the .mustache files you can customise the html markup to your hearts delight.