Main docs in a single page
Separate pages ok for long-form parts, like detailed multi-step tutorials, OAuth, etc...
Inline code examples for each language/library we "support"
Stripe's API Docs has a switcher at top to pick your preferred language.
Use the user's token in examples
If the visitor is logged in to github.com, automatically use their username/token in the examples. We'll probably have
to punt on several of the examples, though. Eg,
/user would show the current user, but we don't want to have to remake