bpo-38255: Replace "method" with "attribute" in the description of super()

[geryogam]

This PR will make the following change to the Built-in Functions chapter of the library documentation:

• replace the word "method" with the more general word "attribute" in the description of super(), since super() is not restricted to method access but can also do data attribute access:

>>> class A:
...     x = True
... 
>>> class B(A):
...     x = False
... 
>>> B().x
False
>>> super(B, B()).x
True

https://bugs.python.org/issue38255

[rhettinger]

I don't want to do this. Delegating methods is the primary use case for super(), perhaps by a factor of over a hundred to one.

We can add "(or attributes)" but should keep the wording focused on methods.

[bedevere-bot]

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

[geryogam]

Alright @rhettinger. I have used "(or data attributes)" instead of merely "(or attributes)" as a method is also an attribute (since the official tutorial uses this nomenclature: "There are two kinds of valid attribute names, data attributes and methods.")

I have made the requested changes; please review again.

[bedevere-bot]

Thanks for making the requested changes!

@rhettinger: please review the changes made to this pull request.

[bedevere-bot]

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

[rhettinger]

See the alternative PR at #16368 which adds a sentence to the section on the various ways to use super().

When people are first taught about super() (something I do frequently), it isn't a good idea to lead-off the discussion with attribute access. If user's first experiment is with attribute access, their odds of success will be low and it will distract from learning the primary, intended use of the tool.

[rhettinger]

Let's not merge this until the alternative PR has been discussed.

[willingc]

Thanks @maggyero for this PR and your efforts on documentation.

After reading this PR and #16368, I believe #16368 covers the most common usage and mentions the possibility of attributes as well. I recommend merging #16368 since I believe it gives more clarity to the reader.

[willingc]

I recommend merging #16368 and closing this PR. Thanks all.

[geryogam]

Thanks @rhettinger for the review and the alternative PR, it makes sense. I am closing this one.