New submission from David Williams :
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, "
--
assignee: docs@python
components: Documentation
messages: 376569
nosy: docs@python, mobiusinversion
priority: normal
severity: normal
status: open
title: Remove Unnecessarily Gendered Language from the Documentation
type: enhancement
versions: Python 3.10, Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python
3.9
___
Python tracker
<https://bugs.python.org/issue41743>
___
___
Python-bugs-list mailing list
Unsubscribe:
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
