Merge pull request #2483 from abarth/route_docs

More dartdoc for routes.dart