I can't say that I've ever assessed the quality of a code comment based on how well it adheres to Strunk & White, nor have I ever been involved with an environment that tries to strongly enforce that specific style of writing. So FWIW, I agree that "clear and concise English" is more relevant to most.
On Fri, Jun 26, 2020 at 9:49 PM Guido van Rossum <[email protected]> wrote: > > Steven just likes an argument. Nobody has ever taken the idea of a standard > for language in comments seriously. It Just doen come up. > > On Fri, Jun 26, 2020 at 18:35 Bernardo Sulzbach > <[email protected]> wrote: >> >> On Fri, Jun 26, 2020 at 9:43 PM Steven D'Aprano <[email protected]> wrote: >>> >>> I dislike Strunk and White, and don't follow it myself (except by >>> accident, as it were) but I've worked with neuro-atypical programmers >>> who found it really useful to have a common standard that they could >>> follow and reduce the uncertainty of what makes for good writing. >> >> >> I agree. >> >> I would like to reinforce that many software engineers today are _not_ >> native English speakers but work with English codebases and write >> documentation in English. >> >> Any standard is better than just asking for "clear and easily >> understandable" and hoping that for some reason every person, no matter >> where they were born and how they learned English, will share your >> definition of "clear and easily understandable" by accident. >> _______________________________________________ >> Python-ideas mailing list -- [email protected] >> To unsubscribe send an email to [email protected] >> https://mail.python.org/mailman3/lists/python-ideas.python.org/ >> Message archived at >> https://mail.python.org/archives/list/[email protected]/message/3MOO4LSWEAOAULDPN4LBHQWIHIRR7U5K/ >> Code of Conduct: http://python.org/psf/codeofconduct/ > > -- > --Guido (mobile) > _______________________________________________ > Python-ideas mailing list -- [email protected] > To unsubscribe send an email to [email protected] > https://mail.python.org/mailman3/lists/python-ideas.python.org/ > Message archived at > https://mail.python.org/archives/list/[email protected]/message/XG4J5U4OVV752TXC66KS7OCVF7XD6TP2/ > Code of Conduct: http://python.org/psf/codeofconduct/ _______________________________________________ Python-ideas mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3/lists/python-ideas.python.org/ Message archived at https://mail.python.org/archives/list/[email protected]/message/Q6YTS77EORYS4MLDB22O4XREO7ZGWMR3/ Code of Conduct: http://python.org/psf/codeofconduct/
