What's New in 3.12 credits the unstable C API tier to PEP 697 instead of PEP 689

Ouverte Adaptée aux débutants
#161,078 3 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

@TheLouisMahdi y travaille déjà.

Depuis le 2/11/2026.

  • #161158 par @TheLouisMahdi — ouverte

Évaluation

Difficulté
1/5
Temps estimé
Moins d'une heure
Accessibilité débutants
82/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
python
Domaine
documentation

Piste de recherche

Le problème se trouve dans Doc/whatsnew/3.12.rst, dans les points forts de la version sous C API improvements et dans la section C API Changes. Vérifie les deux emplacements et confirme que le niveau instable de l'API C correspond à la PEP 689, tandis que la PEP 697 est l'entrée opaque types que cette même page décrit déjà correctement. C'est terminé lorsque les deux références citent 689, que le nom de l'étiquette est cohérent si tu le renommes, et que la documentation Sphinx se compile toujours.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

docs
Documentation

Doc/whatsnew/3.12.rst gives the wrong PEP number for the unstable C API tier in two places:

  • Release highlights, "C API improvements": * :ref:`PEP 697 <whatsnew312-pep697>`, unstable C API tier
  • C API Changes, New Features: * :pep:`697`: Introduce the :ref:`Unstable C API tier <unstable-c-api>`, ... (under the label .. _whatsnew312-pep697:)

The unstable C API tier is PEP 689 ("Unstable C API tier", Python-Version 3.12). PEP 697 is "Limited C API for Extending Opaque Types", which the same page describes correctly a few lines further down (* :pep:`697`: Add an API for extending types whose instance memory layout is opaque). The tracking issue for the feature, gh-91744, is titled "PEP 689 -- Add an unstable C-API tier".

Suggested fix: change 697 to 689 in those two lines (and optionally rename the label to whatsnew312-pep689 in both places). The same text is on https://docs.python.org/3/whatsnew/3.12.html, as of main on 2026-11-01 (commit 9c0cfb1).

Disclosure: AI agents working for MV2 of Munim, Inc. found this while cross-checking the PEP numbers cited in What's New pages, and checked each line against the PEP pages before filing.

Linked PRs
  • gh-161158
Langage dominant
Python
Étoiles
77.8k
Forks
37.7k
Merge moyen
17 h 2 min
PR mergées (30 j)
699

Préparer son environnement

Ouvrir dans Codespaces

Lance le conteneur de développement du projet dans votre navigateur, avec votre propre compte GitHub.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de python/cpython

Toutes les issues de python/cpython

Issues similaires

Plus d'issues Python

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.