It would take a lot of the guess work out of understanding the API if each route's page provided a small handful of working URLs.
This would also serve to provide authoritative examples of the expected results.
Stack Apps is a question and answer site for apps, scripts, and development with the Stack Exchange API. It only takes a minute to sign up.Sign up to join this community
This is going to have to wait until a 1.0 release, otherwise we're going to run the - quite high risk - of having bad examples laying around for new developers to trip over.
Pre-1.0 as much of the help as can reasonably be, will be built auto-magically.