Éric Araujo <[email protected]> added the comment:
+1 for replacing math range notation with English. Much easier for non-math
people that do Python :)
One more nit: Your docstrings use verb forms like “Returns” where PEP 257
advises to use “Return”: “[the 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 ..."”
----------
_______________________________________
Python tracker <[email protected]>
<http://bugs.python.org/issue5094>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe:
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
