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.
Merge pull request #2 from aaronpk/master

Minor text cleanup
Changes from pull request #3 from @aaronpk