Adds documentation on success and error response formats.
Minor cleanup
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
resolved conflicts