diff --git a/pep-0689.rst b/pep-0689.rst index 0513ddcfd219..707923ffa9f9 100644 --- a/pep-0689.rst +++ b/pep-0689.rst @@ -29,9 +29,12 @@ The Python C-API is currently divided into `three tiers `, and requires deprecation warnings before changes - Private (internal) API, which can change at any time. -We need a tier between Public and Private to accommodate tools like -advanced debuggers and JIT compilers, which need access to CPython -internals but assume the C-API they use does not change in patch releases. +Tools requring access to CPython internals (e.g. advanced +debuggers and JIT compilers) are often built for minor series releases +of CPython, and assume that the C-API interals used do not change +in patch releases. To support these tools, we need a tier between the +Public and Private C-API, with guarantees on stability throughout +the minor-series release. Setting Stability Expectations