[Python-checkins] Doc: Do not encourage using a base class name in a derived class (GH-22177)

[methane]

https://github.com/python/cpython/commit/4642ccd1c3e460cb2746d3f2095f1c1d1bafa4fe
commit: 4642ccd1c3e460cb2746d3f2095f1c1d1bafa4fe
branch: master
author: Andre Delfino <adelfino at gmail.com>
committer: methane <songofacandy at gmail.com>
date: 2020-10-21T14:25:05+09:00
summary:

Doc: Do not encourage using a base class name in a derived class (GH-22177)

files:
M Doc/faq/programming.rst

diff --git a/Doc/faq/programming.rst b/Doc/faq/programming.rst
index 2d542cfb1dbb4..57ab3e265f791 100644
--- a/Doc/faq/programming.rst
+++ b/Doc/faq/programming.rst
@@ -1517,18 +1517,18 @@ order` (MRO) with ``type(self).__mro__``, and return the next in line after
 How can I organize my code to make it easier to change the base class?
 ----------------------------------------------------------------------
 
-You could define an alias for the base class, assign the real base class to it
-before your class definition, and use the alias throughout your class.  Then all
+You could assign the base class to an alias and derive from the alias.  Then all
 you have to change is the value assigned to the alias.  Incidentally, this trick
 is also handy if you want to decide dynamically (e.g. depending on availability
 of resources) which base class to use.  Example::
 
-   BaseAlias = <real base class>
+   class Base:
+       ...
+
+   BaseAlias = Base
 
    class Derived(BaseAlias):
-       def meth(self):
-           BaseAlias.meth(self)
-           ...
+       ...
 
 
 How do I create static class data and static class methods?