Error handling guide

[gilgardosh]

There better be an error handling guide, to include:

• REST APIs:

responseByStatusCode:
  200:
    responseSchema: ./someschema.json#/somepath
  404:
    responseSample: ./error-sample.json
    responseTypeName: MyError

• How to handle auth errors