What's New in Python 3.12: move C API at the end

[vstinner]

• Separate Build and C API changes in two sections
• Add sub-sections to the C API changes

[vstinner]

@pablogsal: How can I change the template used to create a new "What's New in Python 3.X" document when a new Python version is created?

PEP 101 says "Add a new whatsnew/3.x.rst file": ok, but what's the template? https://peps.python.org/pep-0101/

[ezio-melotti]

It's probably enough to just list the names, since they are now under the "Removed" section.

Suggested change

	* :c:func:`PyFrame_BlockSetup` and :c:func:`PyFrame_BlockPop` have been removed.
	* :c:func:`PyFrame_BlockSetup` and :c:func:`PyFrame_BlockPop`.

[vstinner]

I prefer to leave it as it is. See What's New in Python 3.11: https://docs.python.org/dev/whatsnew/3.11.html#id8

Also, this PR is only about moving items. Not rephrasing them.

[vstinner]

@ezio-melotti: Feel free to propose a follow-up PR if you want to rephase it ;-) Personally, I like to write sentences which can be read aloud.

[pablogsal]

@pablogsal: How can I change the template used to create a new "What's New in Python 3.X" document when a new Python version is created?

PEP 101 says "Add a new whatsnew/3.x.rst file": ok, but what's the template? https://peps.python.org/pep-0101/

The template is within the release scripts. Here:

https://github.com/python/release-tools/blob/60d0c216a8ad6b298bf6729033a3b674e0f89f8a/run_release.py#L47

[vstinner]

The template is within the release scripts.

Oh thanks, I wrote a PR to update the template: python/release-tools#13