more docs for graph methods

@josephwb (tested compile this time)