Inconsistencies in PEP 1 regarding number assignment
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Aptitud para principiantes
- 65/100
- Tipo de issue
- Documentación
- Claridad
- Bastante claro
- Estado de actividad
- Tranquilo
- Stack tecnológico
- python
- Área
- documentation
Línea de trabajo
Lee PEP 1 en peps.python.org/pep-0001, centrándote en las secciones „PEP editors“, „Submitting a PEP“, „Discussing a PEP“ y „PEP header preamble“ identificadas en la issue. Compara cada referencia con el flujo de trabajo actual para reclamar un número, actualiza después la redacción de forma coherente y verifica que el PEP 1 renderizado ya no describa pasos de asignación obsoletos.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
#3163 updated PEP 1 so the PEP number should be worked out by the author on PR creation, not assigned by an editor once approved.
There are a few places that mention "assign"ing a number and seem a bit inconsistent with this.
-
In https://peps.python.org/pep-0001/#pep-editors
The PEP editors are individuals responsible for managing the administrative and editorial aspects of the PEP workflow (e.g. assigning PEP numbers, ...
A minor one, I can see an argument for leaving it as I guess PEP editors do still "manage" the numbers, but maybe there's a clearer wording.
-
In https://peps.python.org/pep-0001/#submitting-a-pep
- Once approved, they will assign your PEP a number.
Confusing, as the first task in the list is to select a PEP number yourself.
Developers with write access to the PEP repository may claim PEP numbers directly by creating and committing a new PEP.
This no longer seems relevant, anyone can claim a pep number.
Getting a PEP number assigned early can be useful for ease of reference, especially when multiple draft PEPs are being considered at the same time.
Same with this.
-
In https://peps.python.org/pep-0001/#discussing-a-pep
As soon as a PEP number has been assigned and the draft PEP is committed to the PEP repository, a discussion thread for the PEP should be created
Not really incorrect, but mentioning it seems a bit meaningless now.
Once the PEP is assigned a number and committed to the PEP repository, substantive issues should generally be discussed on the canonical public thread
Same here, should just mention "committed to PEP repository".
-
In https://peps.python.org/pep-0001/#pep-header-preamble
The Created header records the date that the PEP was assigned a number
The wording here isn't incorrect, but the change to how numbers are assigned seems to imply that now the "created" date can differ quite significantly from when it is published to https://peps.python.org. It is not clear that this was effect was considered, so I'll create a separate issue to discuss it.
- Lenguaje dominante
- reStructuredText
- Estrellas
- 5k
- Forks
- 1.8k
- Merge medio
- 2 d 4 h
- PR fusionados (30 d)
- 25
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de python/peps
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
-
New PEP Editors? Abiertometa
Dificultad 5/5 Más de una semana Aptitud para principiantes 25/100
-
infra
Dificultad 3/5 1-2 días Aptitud para principiantes 55/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 48/100
-
Mark 3.14 PEPs as Final Abiertometa
Dificultad 3/5 1-2 días Aptitud para principiantes 35/100
Todos los issues de python/peps
Issues similares
-
documentation help wanted
Dificultad 2/5 1-3 horas Aptitud para principiantes 90/100
-
user-reported
Dificultad 2/5 1-3 horas Aptitud para principiantes 85/100
Kong/developer.konghq.com#7316 ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 88/100
HarperFast/skills#96 ·
-
Client support matrix inclusion Abiertoenhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
infinispan/infinispan#18150 ·