Improve error documentation

[nunofgs]

The current error documentation could be improved by stating the actual object structure of the errors, as well as clearly stating the reasoning and distinction between the OAuth errors and the application errors.

Refs #38.