fix errors in readme docs, add reason to error response object