Perhaps it would make sense to keep the example, but caveat it as being redundant given the move to class namespaces being ordered by default?

Perhaps it would make sense to keep the example, but caveat it as being redundant given the move to class namespaces being ordered by default?

The thing is that the example also depends on the fact that a specialized type like OrderedDict was needed to get an insertion-order-preserving dictionary. I think examples of the like "that thing can be implemented with this API like this:" are good, but this particular example depends on several things that have changed.

IMHO, a new example that shows a real benefit from metaclasses would be better.

I think we must not waiting removing bad document until someone writing better document
when we don't know when the better document is finished.

Additionally, metaclass is very complex feature. I don't want to promote using it.
Actually, Python is evolved to solve typical problem without metaclass: __init_subclass__, __class_getitem__, and PEP 520. (Maybe more)

Lack of "typical usecase" is OK. Lack of "example of typical usecase" is OK too.
People can read stdlib's code to know how metaclass is used.

Thanks @andresdelfino for the PR, and @methane for merging it 🌮🎉.. I'm working now to backport this PR to: 3.6, 3.7.
🐍🍒⛏🤖

GH-10567 is a backport of this pull request to the 3.7 branch.

GH-10568 is a backport of this pull request to the 3.6 branch.