Description

encukou

opened on Nov 26, 2025

Issue body actions

Continuing after #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-141984: Reword and reorganize Subscription (and Slicing) docs #141985
• gh-141984: Reword and reorganize the first part of Atoms docs #144117
• [3.14] gh-141984: Reword and reorganize Subscription (and Slicing) docs (GH-141985) #144476
• [3.14] gh-141984: Reword and reorganize the first part of Atoms docs (GH-144117) #144959
• gh-141984: Split Parenthesized form docs into "groups" and "tuple displays" #144964
• gh-141984: Reword docs on "enclosed" atom grammar #148622
• gh-141984: Remove accidental merge markers #150517
• gh-141984: Reword the Generator expressions section #150518
• [3.15] gh-141984: Reword docs on "enclosed" atom grammar (GH-148622) #150552
• [3.15] gh-141984: Reword the Generator expressions section (GH-150518) #151261
• [3.14] gh-141984: Reword the Generator expressions section (GH-150518) #151267
• gh-141984: Move generator iterator reference out of syntax docs #154884
• [3.15] gh-141984: Move generator iterator reference out of syntax docs (GH-154884) #156836
• gh-141984: Add "exhausted" to glossary, link existing mentions #157225
• [3.15] gh-141984: Add "exhausted" to glossary, link existing mentions (GH-157225) #157271
• [3.14] gh-141984: Add "exhausted" to glossary, link existing mentions (GH-157225) #157272
• gh-141984: Reword the "yield expressions"` section #159421
• gh-141984: Reword the "Attribute References" section and "Primaries" intro #161322

Activity

1. encukou

   self-assigned this

   on Nov 26, 2025
2. encukou

   added

   docsDocumentation in the Doc dirDocumentation in the Doc dir

   on Nov 26, 2025
3. github-project-automation

   moved this to Todo in docs issueson Nov 26, 2025
4. github-project-automation

   added this to docs issueson Nov 26, 2025
5. encukou

   added a commit that references this issue on Feb 4, 2026

   gh-141984: Reword and reorganize Subscription (and Slicing) docs (GH-…

   e423e0c
6. miss-islington

   added a commit that references this issue on Feb 4, 2026

   pythongh-141984: Reword and reorganize Subscription (and Slicing) docs (

   0089958
7. encukou

   added 2 commits that reference this issue on Feb 5, 2026

   [3.14] gh-141984: Reword and reorganize Subscription (and Slicing) do…

   f27896c

   pythongh-141984: Reword and reorganize Subscription (and Slicing) docs (

   0b91f57
8. encukou

   added a parent issue on Feb 11, 2026

   • Align the grammar documentation with Python's actual grammar #127833
9. thunder-coding

   added a commit that references this issue on Feb 15, 2026

   pythongh-141984: Reword and reorganize Subscription (and Slicing) docs (

   24d100e
10. encukou

    added a commit that references this issue on Feb 18, 2026

    gh-141984: Reword and reorganize the first part of Atoms docs (GH-144117

    112d8ac
11. miss-islington

    added a commit that references this issue on Feb 18, 2026

    pythongh-141984: Reword and reorganize the first part of Atoms docs (p…

    334ec7e
12. encukou

    added a commit that references this issue on Feb 18, 2026

    [3.14] gh-141984: Reword and reorganize the first part of Atoms docs (G…

    2ae7c2f
13. brijkapadia

    added a commit that references this issue on Feb 28, 2026

    pythongh-141984: Reword and reorganize the first part of Atoms docs (p…

    9891e9c
14. ljfp

    added a commit that references this issue on Apr 25, 2026

    pythongh-141984: Reword and reorganize Subscription (and Slicing) docs (

    449ece2
15. 7 remaining items
16. philthompson10

    added a commit that references this issue on Jun 17, 2026

    pythongh-141984: Reword the Generator expressions section (pythonGH-1…

    1a373fa
17. encukou

    added a sub-issue on Aug 19, 2026

    • Disallow lone starred expressions at the *grammar* level #156058
18. encukou

    removed a sub-issue on Aug 19, 2026

    • Disallow lone starred expressions at the *grammar* level #156058
19. encukou

    added a commit that references this issue on Sep 2, 2026

    gh-141984: Move generator iterator reference out of syntax docs (GH-1…

    7d701eb
20. encukou

    added 2 commits that reference this issue on Sep 10, 2026

    gh-141984: Add "exhausted" to glossary, link existing mentions (GH-15…

    9bd670c

    [3.14] gh-141984: Add "exhausted" to glossary, link existing mentions (…

    04ed190
21. hugovk

    added a commit that references this issue on Sep 10, 2026

    [3.15] gh-141984: Add "exhausted" to glossary, link existing mentions (…

    1c487de
22. clin1234

    added 2 commits that reference this issue on Sep 12, 2026

    pythongh-141984: Move generator iterator reference out of syntax docs (…

    72af5f4

    pythongh-141984: Add "exhausted" to glossary, link existing mentions (p…

    fa648bc
23. picnixz

    marked Documentation Bug in Language Reference 6.2.4 #157365 as a duplicate of this issue on Sep 12, 2026
24. johnslavik

    added a commit that references this issue on Sep 14, 2026

    pythongh-141984: Add "exhausted" to glossary, link existing mentions (p…

    659da79
25. encukou

    added a commit that references this issue on Oct 12, 2026

    [3.15] gh-141984: Move generator iterator reference out of syntax docs (

    de84eb0
26. kevinprimeraquecreo-stack

    added this to Project_VKon Oct 18, 2026
27. github-project-automation

    moved this to Todo in Project_VKon Oct 18, 2026
28. kevinprimeraquecreo-stack

    added this to Project_VKon Oct 18, 2026

Issue actions