Backport PR #4079 on branch 1.12.x (docs: clarify method vs transformer in sc.pp.neighbors)

Backport PR #4079 on branch 1.12.x (docs: clarify method vs transformer in sc.pp.neighbors) #1846