GeezerVison

I left the Changes section as it was for now (aside from minor technical edits), but there were a handful of additional Opcode changes of what seemed to be roughly comparable magnitude to those mentioned that weren't noted here, mostly grouped by a few specific common alterations, that we could include in a final short table (with columns Opcode(s) and Change), if you feel its worth including.

Here are the additional changes that could be mentioned:

The list we have now has all the jump related changes together, but if you split it into a "added" table and a "replaced" table then they are no longer together. I don't know if that's an improvement.

I created an alternative PR -#98566. It tries to consolidate related items into a high level descriptions, rather than enumerate all the changes. Maybe this is more useful for whatsnew. The full details, if you need them, as in the dis doc.

I added an item about the exc-info related changes. Didn't do anything about these:

GET_AWAITABLE

WITH_EXCEPT_START
If the low bit of namei is set, then a NULL is pushed to the stack before the global variable.

LOAD_GLOBAL
i is no longer offset by the length of co_varnames

LOAD_CLOSURE
LOAD_DEREF
LOAD_CLASSDEREF
STORE_DEREF
DELETE_DEREF

Great points, thanks. I've incorporated the changes suggested via your PR, specifically:

• Consolidated the jump opcode additions, replacements and changes (except for the NO_INTERRUPT opcode addition, which didn't appear to be closely related to the others) into a single Replaced table entry with a linked note
• Just linked the high-level jump opcode name patterns, instead of every opcode.
• Added a "Changed" note about the exception stack representation
• (EXC/EG changes were already consolidated)

Beyond that, I've given this PR a major revamp based on your feedback above:

• Converted the "Added" section back to (much shorter) bullets
• Inlined the previous separate notes into the Replaced table
• Combined the previous "Removed" and "Changed" sections into one, condensing the Removed items into a single bullet to take up much less space
• Made additional textual refinements, particularly in the Changed entries, to be both more clear and more concise

In total, this retains nearly the same space consumption of the previous dense wall of flat bullets format (once allowing for the missing substantive additions, replacements and removals added here), while being much easier for the reader to quickly navigate, find what they're looking for and jump to more information in the dis docs.

Flat Bullets	Initial PR	Revised PR