give more details on return values
in docs params go from 1 to 9, explain directed edges
typo