[WIP] Refactor docs

Fix #94.
we should also explain the rest of the `routes:` part