Very early example of what I would like doc strings to feel like

That doesn't mean they will be implemented this way
Move the route metadata stuff to the Swagger package