We should be following the docstring convention described by [PEP 257](http://www.python.org/dev/peps/pep-0257/), which is also what [PEP 8](http://www.python.org/dev/peps/pep-0008/#documentation-strings) and [Google's Python styleguide](http://google-styleguide.googlecode.com/svn/trunk/pyguide.html#Comments) use.