more docs for graph methods