[issue20751] Harmonize descriptor protocol documentation: direct call, super binding with Descriptor Howto docs

[Raymond Hettinger]

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

> I guess here ``obj`` was supposed to be ``a``.

Okay, I updated the variable name to match the rest of the example.

> But is the description correct when it comes to what class is used where?

It looks fine to me.  It is harmonious with the other three entries in the section and every part of the wording is verified in the test code.

> It should be:

Sorry, I disagree with the wordsmithing.  IMO, the additional proposed wording mostly makes it harder to read.  Also, this section is already a bit long. The details on super() are in the main docs for super().  Here we just want to show that super() is one of the four ways to invoke a descriptor.

----------
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue20751>
_______________________________________