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 mobiusinversion
Recipients docs@python, mobiusinversion
Date 2020-09-08.13:23:39
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1599571420.09.0.38882357277.issue41743@roundup.psfhosted.org>
In-reply-to
Content
The Python documentation contains unnecessarily verbose and gendered language which does not enhance clarity, and rather, serves as non-inclusive to the LGTBQ community

For example:
https://www.python.org/dev/peps/pep-3136/


"Introduction
The break statement allows the programmer to terminate a loop early, and the continue statement allows the programmer to move to the next iteration of a loop early. In Python currently, break and continue can apply only to the innermost enclosing loop.

Motivation
If the programmer wishes to move to the next iteration of an outer enclosing loop, or terminate multiple loops at once, he or she has a few less-than elegant options."

There are 2 issues here. First is that break and continue don't allow the programmer to do anything, they cause the program control flow to change. Second, there is no reason to appeal to gendered pronouns which are antiquated. The motivation section could easily be rewritten to a more include and parsimonious form (less chatter):

"Motivation
Python syntax is limited when it comes to moving to the next iteration of an outer enclosing loop, or terminating multiple loops at once, "
History
Date User Action Args
2020-09-08 13:23:40mobiusinversionsetrecipients: + mobiusinversion, docs@python
2020-09-08 13:23:40mobiusinversionsetmessageid: <1599571420.09.0.38882357277.issue41743@roundup.psfhosted.org>
2020-09-08 13:23:40mobiusinversionlinkissue41743 messages
2020-09-08 13:23:39mobiusinversioncreate