[issue29311] Argument Clinic: convert dict methods

[Raymond Hettinger]

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 <report at bugs.python.org>
<http://bugs.python.org/issue29311>
_______________________________________