improve compute_contacts docs

cc @gkiss