[issue46814] Documentation for constructin abstract base classes is misleading

2022-02-21 Thread Raymond Hettinger
Raymond Hettinger added the comment: An analogy may help. Release managers must check the list of release blockers and stop if the list is non-empty. If no release blockers were ever filed, the release blockers list is empty, but it still exists and its definition hasn't changed. The

[issue46814] Documentation for constructin abstract base classes is misleading

2022-02-21 Thread Raymond Hettinger
Raymond Hettinger added the comment: To me, this looks like a way too extensive edit jsut to emphasize a corner case that rarely arises in practice. It bends over backwards to force an awkward definition regarding what an ABC really is. A more minimal edit is to just note that

[issue46814] Documentation for constructin abstract base classes is misleading

2022-02-21 Thread Josh A. Mitchell
Change by Josh A. Mitchell : -- keywords: +patch pull_requests: +29592 stage: -> patch review pull_request: https://github.com/python/cpython/pull/31463 ___ Python tracker

[issue46814] Documentation for constructin abstract base classes is misleading

2022-02-21 Thread Josh A. Mitchell
New submission from Josh A. Mitchell : The docs for the abc[0] module states "With this class, an abstract base class can be created by simply deriving from ABC", and then gives an example of a class with no contents. This is not sufficient to construct an ABC; an ABC in Python additionally