iSharkFly-Open
/
python-peps
mirror of https://github.com/python/peps.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

PEP 8: Change requirement to adhere to Standard English (#1470) 

Instead of requiring that comments be written in Strunk & White Standard English, require instead that English-language comments be clear and easily understandable by other English speakers. This accomplishes the same goal without upholding relics of white supremacy. Many native English speakers do not use Standard English as their native dialect, so requiring conformation to Standard English centers whiteness in an inappropriate and unnecessary way, and can alienate and put up barriers for people of color and those whose native dialect of English is not Standard English. This change is a simple way to correct that while maintaining the original intent of the requirement.
This commit is contained in:
Keara Berlin 2020-06-26 17:15:32 -05:00 committed by GitHub
parent 1fa2817f5f
commit 0c6427dcec
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 2 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
pep-0008.txt
View File

@ -728,7 +728,8 @@ complete sentences, with each sentence ending in a period.
You should use two spaces after a sentence-ending period in multi-
sentence comments, except after the final sentence.
When writing English, follow Strunk and White.
Ensure that your comments are clear and easily understandable to other
speakers of the language you are writing in.
Python coders from non-English speaking countries: please write your
comments in English, unless you are 120% sure that the code will never