add documentation for ball

+documentation which I hope will help to review code