error-annotation

Annotate errors with diagnostic information.

The API docs are currently the only documentation.