Reword the Expressions chapter of the docs
Abierto
@encukou ya está trabajando en esto.
Desde el 26/11/2025.
docs
- Lenguaje dominante
- Python
- Estrellas
- 77.2k
- Forks
- 35.9k
- Métricas de merge de PR
- Métricas de PR pendientes
Descripción
Continuing after https://github.com/python/cpython/issues/127833 and #135676, I'd like to reword and restructure the Expressions section of the Reference documentation.
I think I found a style that works: each section will start with the most obvious things, expand toward a complete & precise description, with examples along the way, and end with the formal grammar. (Currently the grammar is usually listed first, and the author of the prose is tempted to assume that the reader has parsed and understood it.)
Linked PRs
- gh-141985
- gh-144117
- gh-144476
- gh-144959
- gh-144964
- gh-148622
- gh-150517
- gh-150518
- gh-150552
- gh-151261
- gh-151267
- gh-154884
- gh-156836
- gh-157225
- gh-157271
- gh-157272
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.
Evaluación
Este issue todavía no se ha evaluado.