Do you have a question? Post it now! No Registration Necessary. Now with pictures!
August 10, 2009, 3:04 am
rate this thread
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
=E2=80=A2 Language, Purity, Cult, and Deception
=E2=88=91 http://xahlee.org /