Updated route documentation.

Fixes #1847