New submission from Terry J. Reedy: Today there is a fairly long python-list thread about the difficult of finding info on 'dict comprehensions' in the doc. Point 1 is missing index entries. I opened #29981 for this. Point 2 is something I have also noticed: the obscurity of 'Atoms' and 'Primaries' as titles of sections in the Expressions chapter. These are fairly esoteric Computer Science language theory terms. Compare these to beginner-friendly 'Binary arithmetic operators' and 'Comparisons'.
My specific suggestions, subject to change: Atoms, including identifiers, literals, displays, and comprehensions Primaries: attributes, subscripts, slices, and calls ---------- assignee: docs@python components: Documentation messages: 291131 nosy: docs@python, terry.reedy priority: normal severity: normal stage: needs patch status: open title: Reference TOC: expand 'Atoms' and 'Primaries' type: enhancement versions: Python 2.7, Python 3.6, Python 3.7 _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue29983> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
