Update doc notes around use of weakrefs.