Improve api docs and comments for insert/delete edges

Signed-off-by: Ken Barber <ken@bob.sh>