Add error handling examples to documentation

[mehaase]

Error handling is a little tricky in Trio... After #132 we should probably add some documentation that shows common error handling scenarios. Here's an example of something I messed up: python-trio/trio#611 (comment)