Add internal documentation about errors

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!