This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author rhettinger
Recipients barry, docs@python, maxking, r.david.murray, rhettinger, serhiy.storchaka
Date 2020-07-26.19:51:59
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1595793119.73.0.716587398725.issue41400@roundup.psfhosted.org>
In-reply-to
Content
From a user point of view, your edit makes it look like they have to supply __ne__() if they want support for the != operator.  The user would have to know the subtle details of the language to know this is not the case.  In documentation, more so than in code, explicit is better than implicit.

The tables that we have now do a good job of communicating, "if you supply these methods, then these other methods follow automatically".  It matters very little where those methods were defined in the __mro__.  In Python 2.7, collections.Set used to explicitly define __ne__ and now it just inherits it from object, but that is close to being just an implementation detail.  From a user point of view, it is the same.

It would fine to add a technical implementation note somewhere, perhaps as a footnote to the "Mixin Methods" column.  But mostly, the documentation is more useful and clear as it stands now.  In my professional life, I teach engineers directly from these tables, so I have extensive experience with the user's point of view on these particular docs.
History
Date User Action Args
2020-07-26 19:51:59rhettingersetrecipients: + rhettinger, barry, r.david.murray, docs@python, serhiy.storchaka, maxking
2020-07-26 19:51:59rhettingersetmessageid: <1595793119.73.0.716587398725.issue41400@roundup.psfhosted.org>
2020-07-26 19:51:59rhettingerlinkissue41400 messages
2020-07-26 19:51:59rhettingercreate