Update docs for routing
Update docs for routing

- Update all the examples so they work
- Add additional examples in a separate section
- Add a short note for ZF1 devs
- Rename "Route Types" to "HTTP Route Types"
- Add a note about Part routes that they're not meant to be
 used directly
- Add a link to console routes and routing
- Add a warning on common pitfalls with child routes

akrabat/zf2-documentation,rettal/zf2-documentation,Rud5G/zf2-documentation,samsonasik/zf2-documentation,rettal/zf2-documentation,samsonasik/zf2-documentation,akrabat/zf2-documentation,gennadiylitvinyuk/zf2-documentation,gennadiylitvinyuk/zf2-documentation,Rud5G/zf2-documentation