Signed-off-by: Philip Withnall <pwithnall@gnome.org> Helps: #3037
And add some new sections on strategies for avoiding designing APIs around floating refs. Helps: #3037