MRO summary description in tutorial still says depth-first

[drewarnett]

Documentation

Tutorial - Classes chapter - Multiple Inheritance section has a summary description of MRO which
still says depth first. That applied to classic Python2 (old) classes.

Linked PRs

• gh-125904: fix MRO summary discription in tutorial #125905
• gh-125904: Fix MRO summary description in tutorial #125906

[drewarnett]

Providing a PR.

[drewarnett]

In PR #125906 @erlend-aasland asked "What about the following example in L643-L645?" which is a good point.

Have thought about this more. I had taken the second paragraph in this section as providing a summary description. But maybe should consider the entire section? If "simplest case" means object is the only common parent, and if one ignores object, then the original text is correct for that simplest case.

If the second paragraph is providing a summary description, perhaps that first sentence could read instead:

"For most purposes, you can think of the search for attributes inherited from a parent class as depth-before-common-parent-first, left-to-right, followed by common parents, in a de-duplicated fashion."

Say something like "For exact details, see python_2.3_mro." earlier perhaps before the paragraph starting "In fact, it is slightly more complex than that..."?

Right now I'm inclined to cancel PR #125906 for original or wording that is actually better.

[drewarnett]

I don't think much belongs in the tutorial other than to say multiple inheritance is available, maybe a summary description, and refer the reader to python_2.3_mro as early as possible.  Or have the simple example with only object as common parent and a second example with a common object before parent, like one of the examples from python_2.3_mro.

[erlend-aasland]

I don't think much belongs in the tutorial other than to say multiple inheritance is available, maybe a summary description, and refer the reader to python_2.3_mro as early as possible.  Or have the simple example with only object as common parent and a second example with a common object before parent, like one of the examples from python_2.3_mro.

I agree that nitty gritty details about the MRO does not necessarily need to be a part of the tutorial. A .. seealso that points to an explanatory section sounds like an improvement to me.

But maybe should consider the entire section?

Yes, I think one should consider the entire section.