add some notes and doc strings to neighbors cython code