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.
That is actually described just below. I can rephrase this a little.