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.
GET is for historical reasons, described in #72