Can I suggest an addition to this discussion that the phrase: "Must adhere to python community guidelines" otherwise it is possible to be disrespectful, abusive, sexist, etc., while being clean and understandable (and even adhering strictly to Strunk & White). It is completely possible to be hateful in many ways while sticking to any grammatical rules. A possible example (taken from some real commercial code that the customer would be taking delivery of): "This function is a drop in replacement for the complete waste of space originally written by <anatomically accurate but improbable description> <full name of original coder>." - (when I found this in the code base I did manage to get it replaced but not without resistance from some parties).
Personally I think that community guidelines is better than trying to spell out what is unacceptable in a document such as PEP-8.
-----Original Message----- From: Greg Ewing firstname.lastname@example.org Sent: 27 June 2020 07:09 To: email@example.com Subject: [Python-ideas] Re: Amend PEP-8 to require clear, understandable comments instead of Strunk & White Standard English comments
On 27/06/20 5:30 pm, David Mertz wrote:
My point is that _Elements of Style_ is not a set of rules. It's a nice book with generally good advice; it's not a style guide in a formal sense.
Also, does it actually say anything that would forbid or discourage use of terms such as "chocker" and "chuck out"?
Python-ideas mailing list -- firstname.lastname@example.org To unsubscribe send an email to email@example.com https://mail.python.org/mailman3/lists/python-ideas.python.org/ Message archived at https://firstname.lastname@example.org/message/2YJHM7... Code of Conduct: http://python.org/psf/codeofconduct/