[New-bugs-announce] [issue29983] Reference TOC: expand 'Atoms' and 'Primaries'

[Terry J. Reedy]

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 at python
components: Documentation
messages: 291131
nosy: docs at 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 <report at bugs.python.org>
<http://bugs.python.org/issue29983>
_______________________________________