+doc: Document graph cycles

initial version
can be moved up as a class field, and reused