This is being nit-picky, but the convention is for the first line of a docstring to stand on its own. If you need multiple lines to describe something, then that goes after an additional empty line. See: http://google-styleguide.googlecode.com/svn/trunk/pyguide.html?showone=Comments#Comments The reason for this is because of how editors and automatic documentation generators will parse/display docstrings.