On Tue, 12 Apr 2022, 3:59 am Guido van Rossum, <guido@python.org> wrote:
In the sentence starting with

Types whose methods need access to their module instance will be converted to heap types[...]

please emphasize (bold!) "whose methods need access to their module instance".

Also emphasize this paragraph:

"Static types that do not need module state access, and have no other reason to be converted, should stay static."

I hadn't noticed the qualification in the first sentence and had assumed all types were to be converted, until I came across the second at the very end of the section (where it is easily overlooked by lazy readers :-).


Making that final paragraph the first paragraph in the section should help on both points (reminds me of flipping an if/else in code so the one-liner branch is the first one).

Definite +1 from me on the overall PEP.

Cheers,
Nick.