PEP 484: NewType is now a class, not a function

[Fidget-Spinner]

Since Python 3.10, we've changed PEP 484's NewType to a class, not a function, so this section is misleading.

Should we update it? Or do we leave it as is?

CC @JelleZijlstra and @gvanrossum

[AlexWaygood]

I recently had a PR to the mypy docs accepted, tackling this issue: python/mypy#11621

I think similar changes to PEP 484 would be good.

[JelleZijlstra]

PEPs are historical documents, not living documentation, and at some point we should stop changing them. I guess we previously discussed this in #1942 and #2158.

For this particular change, I don't think it's especially important that PEP 484 is exactly correct. It's just an implementation detail.

[gvanrossum]

Indeed. PEP 484 is no longer provisional.

[CAM-Gerlach]

Indeed. PEP 484 is no longer provisional.

@gvanrossum It looks like it is still marked as such—should it be updated?

[gvanrossum]

Yeah, should be Final. :-)

[CAM-Gerlach]

Opened as PR #2380