Add more prose to requests API docs

In a discussion with Everett Toews, he pointed out that our API docs could use a bit of motivation.
Ok.