Bitching about the documentation...

Steven D'Aprano steve at
Wed Dec 7 18:50:16 CET 2005

On Wed, 07 Dec 2005 07:50:14 -0800, Alex Martelli wrote:

> Steven D'Aprano <steve at> wrote:
>> On Mon, 05 Dec 2005 19:36:58 -0800, BartlebyScrivener wrote:
>> > Well, that might be asking a bit too much of the programmers, who
>> > perhaps don't exactly enjoy mucking about in the lowlands of English
>> > grammar and syntax.
>> Oh come on now! For the kinds of minds who enjoy obfuscated C or Perl,
>> English is just par for the course.
> As it happens, there appears to be pretty weak correlation between
> proficiency in programming and proficiency in writing -- SOME excellent
> programmers are great writers too, but, I would guess, just roughly the
> same percentage as in the general popularion (i.e., deucedly few).

If you know any links to real research on this, I'd love to learn more.
I'm always amazed and perplexed at how hot-shot programmers who would
never forget a colon or a brace can be so slap-dash about using proper
punctuation and grammar in English.


More information about the Python-list mailing list