Adds documentation on success and error response formats.
Default to use HTML responses for everything unless an explicit `Accept` header is set.
Merge pull request #1 from aaronpk/response

Adds documentation on success and error response formats.