This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author terry.reedy
Recipients docs@python, terry.reedy
Date 2017-04-04.18:31:12
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1491330672.66.0.700114037172.issue29983@psf.upfronthosting.co.za>
In-reply-to
Content
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
History
Date User Action Args
2017-04-04 18:31:12terry.reedysetrecipients: + terry.reedy, docs@python
2017-04-04 18:31:12terry.reedysetmessageid: <1491330672.66.0.700114037172.issue29983@psf.upfronthosting.co.za>
2017-04-04 18:31:12terry.reedylinkissue29983 messages
2017-04-04 18:31:12terry.reedycreate