python / python/cpython

Descrição

My original question has answered by Stan. I leave it here as a record:

Click to expand

I'm not sure if it's done deliberately, but it seems odd to me and I can't find out why it happens so far.

---

The reference/grammar.rst includes Grammar/python.gram

https://github.com/python/cpython/blob/78a50ee10ef73296eba98899d496bff3915ddc41/Doc/reference/grammar.rst#L18-L19

and Grammar/python.gram has a section for invalid rules at the bottom.

https://github.com/python/cpython/blob/78a50ee10ef73296eba98899d496bff3915ddc41/Grammar/python.gram#L1193-L1202

However, the content after START OF INVALID RULES is missing on the page

snapshot

I checked the previous version and found out the doc has this issue since 3.11 (after PEG parser is introduced).

---

Other info:
I translated this page into Traditional Chinese (zh-tw) recently and somehow it shows correctly on the translated page

snapshot

So here's the revised issue description:

Some elements in Grammar/python.gram are stripped by peg_lexer.py, and hence they're hidden on the reference/grammar docs. However, the full content of Grammar/python.gram is still remained in the generated PO files (e.g. the one in zh-tw).

Guia de contribuição

Abrir o guia de contribuição

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.

Direção de pesquisa

Avaliação

Stack de tecnologia

python

Domínio

documentation, tooling

Tipo de issue

Bug

Dificuldade

4/5

Tempo estimado

3-5 dias

Status de atividade

Estagnada

Clareza

Precisa de esclarecimento

Facilidade para iniciantes

30/100