question: How to write examples?

[duesee]

I feel that we should write "production ready" examples. Handling (recoverable) errors, never panicking, etc.

The reason is that I'd like us to feel the error handling pain first. Also, examples tend to get copied all over the place, maybe we should anticipate that.

One downside of handling errors is that -- w/o further ado, logging, etc. -- it's more difficult to pin down errors while unwrap instantly points you to the offending line. But, given that examples are small, this might not be an issue.