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 <gu...@python.org> 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 > <berna...@bernardosulzbach.com> wrote: >> >> On Fri, Jun 26, 2020 at 9:43 PM Steven D'Aprano <st...@pearwood.info> 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 -- 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/3MOO4LSWEAOAULDPN4LBHQWIHIRR7U5K/ >> Code of Conduct: http://python.org/psf/codeofconduct/ > > -- > --Guido (mobile) > _______________________________________________ > 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/XG4J5U4OVV752TXC66KS7OCVF7XD6TP2/ > Code of Conduct: http://python.org/psf/codeofconduct/ _______________________________________________ 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/Q6YTS77EORYS4MLDB22O4XREO7ZGWMR3/ Code of Conduct: http://python.org/psf/codeofconduct/
