Here are two docs that we should follow: http://www.python.org/peps/pep-0008.html http://www.python.org/peps/pep-0257.html It's a good idea if we use __doc__ strings to document everything, even though the PEP only requires you use __doc__ on external interfaces, using __doc__ for both will facilitate the community development effort. --Ivan