docs: document gobject weakrefs

@lovetox asked yesterday how to handle weakrefs + gobjects, where I recommended to add a dummy state on the gobject so it's lifetime is tied to the wrapper and one case use Python weakrefs.

Turns out there also is GObject.Object.weak_ref(callback, *args)

We should document it somewhere.