Author rhettinger
Recipients eric.snow, larry, martin.panter, methane, python-dev, rhettinger, serhiy.storchaka, vstinner
Date 2017-05-03.16:05:14
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1493827514.39.0.488324871804.issue29311@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2017-05-03 16:05:14rhettingersetrecipients: + rhettinger, vstinner, larry, methane, python-dev, eric.snow, martin.panter, serhiy.storchaka
2017-05-03 16:05:14rhettingersetmessageid: <1493827514.39.0.488324871804.issue29311@psf.upfronthosting.co.za>
2017-05-03 16:05:14rhettingerlinkissue29311 messages
2017-05-03 16:05:14rhettingercreate