python / cpython

The Python programming language
https://www.python.org
Other
62.75k stars 30.08k forks source link

syntax diagram after EBNF description? #67328

Open f5cd79f7-5c15-4807-8883-a00743b2d534 opened 9 years ago

f5cd79f7-5c15-4807-8883-a00743b2d534 commented 9 years ago
BPO 23139
Nosy @isidentical

Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.

Show more details

GitHub fields: ```python assignee = None closed_at = None created_at = labels = ['docs'] title = 'syntax diagram after EBNF description?' updated_at = user = 'https://bugs.python.org/FriedrichSpeevonLangenfeld' ``` bugs.python.org fields: ```python activity = actor = 'BTaskaya' assignee = 'docs@python' closed = False closed_date = None closer = None components = ['Documentation'] creation = creator = 'Friedrich.Spee.von.Langenfeld' dependencies = [] files = [] hgrepos = [] issue_num = 23139 keywords = [] message_count = 2.0 messages = ['233236', '359816'] nosy_count = 3.0 nosy_names = ['docs@python', 'Friedrich.Spee.von.Langenfeld', 'BTaskaya'] pr_nums = [] priority = 'normal' resolution = None stage = None status = 'open' superseder = None type = None url = 'https://bugs.python.org/issue23139' versions = [] ```

f5cd79f7-5c15-4807-8883-a00743b2d534 commented 9 years ago

In our full grammar specification (10th chapter of the language reference, https://docs.python.org/3/reference/grammar.html), the grammar of Python is comprehensively notated. What would you think of adding a picture with an equivalent syntax diagram (e. g. produced with the help of http://www.bottlecaps.de/rr/ui) to open a new way of understanding for readers?

isidentical commented 4 years ago

I am not sure but I suspect it would look to complex to a reader if all grammar visualized.