First pass at improving Routing DSL `route` vs `resource` docs

I noticed that the router guide was not very clear about the difference between `route` and `resource` in the router DSL especially given that `route` can have nested routes since 1.7.

First pass only, happy to make changes :-)