Social problems of Python doc [was Re: Python docs disappointing]

Do you have a question? Post it now! No Registration Necessary.  Now with pictures!

The prob with python docs is with the python priests.

there are frequent posts about python doc's poor quality, and some
efforts to improve the doc (such as wiki or seggestions), about few
times a year (in so much as i've seen), the typical response is
pissing fight, with python priests to tell them not to start another
wiki, or80=9Cyou should apply in our church first and formulate a PEP
proposal first or kindly donate or otherwise fuckoff=E2=80=9D, and so on.

i've wrote several articles about this issue, total time spend on this
is probably more than 2 months full-time work. See:

=E2=80=A2 Python Documentation Problems

just about each article above generates a thread of flames.

I also have re-wrote the entire python regex doc in 2005:

=E2=80=A2 Pyhton Regex Documentation: String Pattern Matching

there are some positive reviews, but most are drawn out by nay-sayers.

I often receive thank you emails for 2 particular articles, which are
most frequently google searched as indicated by my weblog:

=E2=80=A2 Python Doc Problem Example: gzip

=E2=80=A2 Python Doc Problem Example: sort()

=E2=80=A2 Sorting in Python and Perl

See also:

=E2=80=A2 Language, Purity, Cult, and Deception

=E2=88=91 /


Quoted text here. Click to load it

Site Timeline