Éric Araujo <mer...@netwok.org> 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 <rep...@bugs.python.org>
<http://bugs.python.org/issue5094>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to