Add a page on changing the C API (PEP-652) by encukou · Pull Request #682 · python/devguide

the-knights-who-say-ni

This repeats points currently said in `Include/README.rst`.
I intend to replace most of that README with a link to this document.

The main change from that document are:
- The three "rings" are not defined by where things are declared.
  It would be good to have them in the right place, but it's
  not yet the case, and for technical reasons we might never reach
  the ideal. (In `Include/README.rst` it makes more sense to make
  the locations more prominent.)
- The order is switched. For changing the Limited API you generally
  need to read (and follow guidelines in) the preceding sections
  as well.

I added points from PEP 652 (Maintaining the Stable ABI).

encukou added a commit to encukou/cpython that referenced this pull request

Apr 29, 2021

AA-Turner pushed a commit to AA-Turner/devguide that referenced this pull request

Jun 17, 2022

This repeats points currently said in `Include/README.rst`.
I intend to replace most of that README with a link to this document.

The main change from that document are:
- The three "rings" are not defined by where things are declared.
  It would be good to have them in the right place, but it's
  not yet the case, and for technical reasons we might never reach
  the ideal. (In `Include/README.rst` it makes more sense to make
  the locations more prominent.)
- The order is switched. For changing the Limited API you generally
  need to read (and follow guidelines in) the preceding sections
  as well.

On top of that, I addes points from PEP 652 (Maintaining the Stable ABI).


Co-Authored-By: Erlend Egeberg Aasland <erlend.aasland@innova.no>