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 |