Hi all, this is a very small change, but I thought I would field it here to see
if anyone has suggestions or ideas. Instead of requiring that comments be
written in Strunk & White Standard English, PEP-8 should require instead that
English-language comments be clear and easily understandable by other English
speakers. This accomplishes the same goal without alienating or putting up
barriers for people (especially people of color) 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 change may even
make the requirement more clear to people who are not familiar with Strunk &
White, since for programmers, the main relevant aspect of that standard is "be
clear and concise;" simply saying that instead of referencing Strunk & White
may communicate this more effectively.
Here is the current line in PEP-8: "When writing English, follow Strunk and
White."
I propose changing this line to "When writing English, ensure that your
comments are clear and easily understandable to other English speakers."
_______________________________________________
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at
https://mail.python.org/archives/list/python-ideas@python.org/message/AE2M7KOIQR37K3XSQW7FSV5KO4LMYHWX/
Code of Conduct: http://python.org/psf/codeofconduct/
