[docs] [issue15457] consistent treatment of generator terminology

Chris Jerdonek report at bugs.python.org
Thu Jul 26 13:37:56 CEST 2012

New submission from Chris Jerdonek <chris.jerdonek at gmail.com>:

The documentation on generators (outside of PEP 255) does not currently educate the reader on the more specific  "generator function" and "generator iterator" terminology, or at least not in any consistent or systematic way.

For example, the glossary includes only a single entry for "generator," and that entry does not mention the two more specific forms.

I think it would help for general discourse purposes if this distinction were made clearer, while still continuing to allow for the use of the generic word "generator" when the context makes it clear.

There are also cases where index entries can be improved in this regard, and where references to the section containing details about generators can still be added.  I am in the process of completing a proposed patch.

assignee: docs at python
components: Documentation
keywords: easy
messages: 166474
nosy: cjerdonek, docs at python
priority: normal
severity: normal
status: open
title: consistent treatment of generator terminology
versions: Python 3.3

Python tracker <report at bugs.python.org>

More information about the docs mailing list