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. Steve Barnes -----Original Message----- From: Greg Ewing <greg.ewing@canterbury.ac.nz> Sent: 27 June 2020 07:09 To: python-ideas@python.org 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"? -- Greg _______________________________________________ Python-ideas mailing list -- python-ideas@python.org To unsubscribe send an email to python-ideas-leave@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/2YJHM7... Code of Conduct: http://python.org/psf/codeofconduct/