[WIP] Refactor docs

Fix #94.
What would the syntax be like, in your proposal? I think just supplying one list of route params, and differentiating between them with a literal string versus key/value `{"expression": "id"}` is most user-friendly. Do you have time to open a PR for this?