Add detailed error example and error article

[glbrntt]

Motivation:

We should document how service authors and clients should
deal with errors and what options are available to them.

Modifications:

• Add an article explaining what the error mechanisms available
• Add an example

Result:

Better docs

[glbrntt]

This is split into multiple commits. Note that b76d42f is just adding the generated code.