docs: Add introduction to handling GLib.Error
As suggested in #199. I wasn't sure if you really wanted this at User Guide level... it seemed to me to fit better into the API subsection, but happy to move it if you'd prefer.
Also, I'm not sure if this is too detailed/verbose. Let me know if you'd like me to try and shorten it a bit.