What did you have in mind?
I'm looking at the ToC of What's new in 3.13, which looks like:
...
Optimizations
Removed Modules And APIs
...
New Deprecations
Pending Removal in Python 3.14
Pending Removal in Python 3.15
Pending Removal in Python 3.16
Pending Removal in Future Versions
CPython Bytecode Changes
C API Changes
New Features
Build Changes
Porting to Python 3.13
Changes in the Python API
Changes in the C API
Removed C APIs
Deprecated C APIs
Pending Removal in Python 3.14
Pending Removal in Python 3.15
Pending Removal in Future Versions
Regression Test Changes
...
There are a few issues here:
- The "Pending Removal"s don't seem to belong under "New Deprecations", assuming they also include existing deprecations carried over from previous versions.
- It also seems that some (all?) new deprecations are also duplicated under the "Pending Removal"s.
- All these sections except "Pending Removal in Future Versions" have no introductory paragraph to explain briefly what are they listing (possibly including the fact that some entries are duplicated and that old deprecations are included too).
- Under "Porting to Python 3.13" there's another set of "Pending Removal"s, with no clear indication of the difference with the previous set. Since the title is the same, it creates a conflict in the link fragment (and the fragment is replaced by an
#idxx)
- This part also doesn't mirror the previous one, with "Deprecated C APIs" seemingly being the C equivalent of the previous "New Deprecations", even though it's now on the same level.
- This new set of "Pending Removal"s seems to be about C APIs, but this is not clear from the title, and it's also not explicitly mentioned in the sections themselves.
- The "Porting to Python 3.13" section should arguably also contains the first set of "Pending Removal"s, or maybe both sets should be moved before and referenced where needed.
- "Pending Removal in Python 3.16" is missing from the second set (maybe intentionally if there are no new deprecations? should it still be added with a short note stating that there are currently no deprecations about features removed in 3.16?)
Taking a step back, we might want to separate both Python changes from C changes (this applies to rest too) or new vs existing deprecations (this only applies to deprecation), i.e.:
Python changes
New APIs
Deprecations
New Deprecations
Pending removal in 3.x
Pending removal in future versions
C changes
New APIs
Deprecations
New Deprecations
Pending removal in 3.x
Pending removal in future versions
or
...
New APIs
Python APIs
C APIs
Deprecations
New Deprecations
Python Deprecations
C Deprecations
Pending removal in 3.x
Python
C
...
Pending removal in future versions
Python
C
IOW, either the structure of the document is confusing (and should be fixed), or I am misunderstanding it (which probably means that it's confusing (and should be fixed)).