This adds documentation about how various classes of errors are handled
in `gobject_gen!`, hopefully providing useful context to those who
wonder how it all fits together!