API clean-up and docs

- loadHandlers is renamed to fromDirectories
- A `method` member in a route is returned in `match` objects, rather than the
  full route. This simplified usage and makes the common case (use for swagger
  routing) more intuitive.
- Finally there are docs.