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.
So POST is for executing a script that you pass along with the request but GET is for executing a script (or zapp) that is already in a container?