reviewed routing documentation

| Q   | A
| --- | ---
| Doc fix? | yes
| New docs? | yes
| Applies to | dev
| Fixed tickets | #459