also note that *The docstring is a phrase ending in a period. It prescribes the function or method's effect as a command ("Do this", "Return that"), not as a description; e.g. don't write "Returns the pathname ...".*

http://legacy.python.org/dev/peps/pep-0257/