[class-inheritance] Concept Documentation

[girijakar]

Concept documentation for issue #2351 #2972

[BethanyG]

Hi @girijakar 👋🏽

Thank you for submitting this PR. 😄 Were you intending to do a PR for issue #2350? There appears to be a lot of information about class members in this particular about doc that should go with class-customization (the prerequisite exercise to this one) and not class-inheritance.

The about docs for this concept -class-inheritance -should only cover and extend upon the bullet points listed in the Learning Objectives section of issue #2351 which are:

• more fully understand the uses (and possible abuses) of classes in Python
• understanding and use of single inheritance in Python
• understanding and use of multiple inheritance in Python
• the diamond inheritance problem
• Pythons MRO (method resolution order)
• pros and cos of mixins () to isolate multiple inheritance issues
• when and when not to use __super__() to call a parent class constructor

Additionally, the concept introduction doc is missing from the set. It should be brief introduction to the concept topic.

Are you also going to work on the exercise for this concept? Both issue #2350 and #2351 are for concept exercises as opposed to concept docs -- although the concept docs can be submitted as part of the concept exercise.

Please let me know -- and if you are only working on the concept docs, I will write up a new issue for you.

[girijakar]

Oh!
I want to work on #2351 issue for now. After finishing #2351 I'll try to give #2350 a go.

Can you tell me what other uses of class I can include for the first bullet point?
Is Introduction.md the concept introduction doc?

I apologize for the mistake 😶

[kotp]

I have set this to draft as it is not yet ready for review.

Is Introduction.md the concept introduction doc?

Yes.

more fully understand the uses (and possible abuses) of classes in Python
Can you tell me what other uses of class I can include for the first bullet point?

If you can think of at least 1 or 2, place them in the documentation. This can grow as you develop the documentation, I am sure you will realize other uses as it gets fleshed out.

---

Thank you for working on this!

[girijakar]

OK, but introduction.md doc is there in the set.

[BethanyG]

@girijakar - So it is! My apologies for missing it! I will give this a more through read-through in the morning my time (I'm in the pacific time zone). will you also be submitting the exercise portion of the issue in this PR or a follow on PR -- or are you only wanting to work on the concept as opposed to the exercise?

[girijakar]

@BethanyG I want to work on the concept only for now ☺
Apologies for the delay in reply.

[BethanyG]

@girijakar - apologies for the delay! I've opened a new issue that covers just the concept documents. It's #2972. I've linked this PR to it.

[girijakar]

@BethanyG Today I've commited your suggestions. Soon will work on rearranging/rewording/removing the concepts.

[BethanyG]

@girijakar - That's awesome news! Thanks so much for working on this. I am a bit swamped with work, but will make sure to give this a good look over the weekend.

[BethanyG]

@girijakar are you still working on this? Given its age, I am going to "optimistically merge" this as-is, and if you wish to continue working on revisions, you can submit a follow-on PR. Just ping and let us know.

I will file an improvement issue for these docs, and you are more than welcome to then pick that up. Thanks again for all your work on this! 💙

[BethanyG]

Optimistically merging.