Raymond Hettinger added the comment:

IMO, you've made the docstrings for pure Python versions of 
collections.OrderedDict worse.  The previous docstrings were clearer.

Please note, there is a high bar for altering docstrings that have worked well 
(been deployed with success) for over 15 years (they were modeled on the dict 
object docstrings).  You're undoing some of the work originally done by Guido 
van Rossum and Tim Peters.

Argument clinic was accepted on the premise that it would add useful 
information, not that it would entail a wholesale rewrite of every docstring.

----------

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue29311>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to