Add some documentation

PHYS-16 #time 45m

I'm really combing through this Barnes-Hut code trying to find the
disconnect, but I still can't see it.