Error handling api design

[rickwierenga]

see also this post: Clarifying / revising error handling