Document handle_errors

I don't consider myself good at writing these kinds of prose docs, but it's a start.  I'll change things according to feedback.