Updated route documentation.
Updated wording of query parameters.
Merge pull request #1851 from arb/route-verbage

Updated route documentation.