rewriting the routing doc

| Q             | A
| ------------- | ---
| Doc fix?      | yes
| New docs?     | yes
| Applies to    | all
| Fixed tickets | part of #262

- [x] Routing component
- [ ] Routing bundle
- [ ] Routing configuration reference
- [ ] Routing book chapter