pep 257 -- docstring conventions, as well as a myriad of books and other
resources, recommend documenting a function's or method's effect as a command
("do this", "return that"), not as a description ("does this", "returns that").
what's the logic behind this recommendation?bagratte -- https://mail.python.org/mailman/listinfo/python-list
