classification
Title: Update Index for set, dict, and generator 'comprehensions'
Type: behavior Stage: needs patch
Components: Documentation Versions: Python 3.7, Python 3.6
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, louielu, terry.reedy
Priority: normal Keywords: easy

Created on 2017-04-04 18:01 by terry.reedy, last changed 2017-04-05 05:08 by louielu.

Pull Requests
URL Status Linked Edit
PR 995 open louielu, 2017-04-05 05:08
Messages (2)
msg291129 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2017-04-04 18:01
The index currently has

comprehensions
   *list*

with *list* linked to 6.2.5 List displays.  I suggest:

1. Link *comprehensions* to 6.2.4. Displays for lists, sets and dictionaries
2. Add subentries *set*, *dict*, and *generator* linked to
2a. 6.2.6. Set displays
2b. 6.2.7. Dictionary displays
2c. 6.2.8. Generator expressions

We don't *call* generator expressions 'generator comprehensions', but that is what they are syntactically and one looking for 'comprehensions' should be able to find them there.

There is already

*list*
   ...
   *comprehensions*
   ...
*list comprehensions*

with 'list' and 'list comprehensions' linked to glossary entries, while 'list, comprehensions' links to the same section as 'comprehensions, list'.  

3. Add 'set/dictionary, comprehensions' sub-entries linked like 'list, com
4. Add Glossary entries and links like 'list comprehensions'
msg291132 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2017-04-04 18:33
See #29983 for expanding the title of the 'atoms' section containing subsections on comprehensions.
History
Date User Action Args
2017-04-05 05:08:07louielusetpull_requests: + pull_request1170
2017-04-05 04:35:34louielusetnosy: + louielu
2017-04-04 18:33:04terry.reedysetmessages: + msg291132
title: Update Index set, dict, and generator 'comprehensions' -> Update Index for set, dict, and generator 'comprehensions'
2017-04-04 18:01:11terry.reedycreate