Flesh out the API docs.

Give lots of details about the use of Mercenary.

/cc @imathis