Whilst I am being fussy (feel free to ignore me), PEP257 says a docstring 

> 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 ..."