Improve documentation for the `aws-smithy-http-server` crate (#901)

The changes are mostly stylistic. The only important change is that the
`routing` module and `Router::into_make_service` method have been made
doc-public, because users need to call `into_make_service` to feed the
returned `MakeService` to their `hyper` server.