[issue12192] Doc that collection mutation methods return item or None

[Raymond Hettinger]

Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

+1 on the doc suggestions

-1 on any hope that casual users will have read or remembered them.  ISTM that a common theme among the post of people getting tripped-up by this is that they aren't doing more than a quick skim of the docs anyway.

----------
nosy: +rhettinger

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue12192>
_______________________________________