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

Aberta Para iniciantes
#161,078 3 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

@TheLouisMahdi já está trabalhando nisso.

Desde 2/11/2026.

  • #161158 de @TheLouisMahdi — aberto

Avaliação

Dificuldade
1/5
Tempo estimado
Menos de uma hora
Facilidade para iniciantes
82/100
Tipo de issue
Documentação
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
python
Domínio
documentation

Direção de pesquisa

O problema está em Doc/whatsnew/3.12.rst, nos destaques da versão em C API improvements e na seção C API Changes. Verifique os dois pontos e confirme que o nível instável da C API é a PEP 689, enquanto a PEP 697 é a entrada de opaque types que a mesma página já descreve corretamente. Está concluído quando as duas referências citam 689, o nome do rótulo é consistente caso você o renomeie, e a documentação do Sphinx continua sendo construída.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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
Linguagem predominante
Python
Estrelas
77.8k
Forks
37.7k
Merge médio
17h 24min
PRs com merge (30d)
716

Preparar o ambiente

Abrir no Codespaces

Inicia o contêiner de desenvolvimento do projeto no navegador, com a sua própria conta do GitHub.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de python/cpython

Todas as issues de python/cpython

Issues semelhantes

Mais issues de Python

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.