Python documentation problem

Xah Lee xah at xahlee.org
Sat Jun 18 11:49:38 CEST 2005


> what is wrong with python doc
> http://python.org/doc/2.4.1/lib/typesfunctions.html

the problem is that the page essentially says nothing. Nothing that is
relevant to programing, and such nothingness occupies a significant
portion of the python doc. (at least a quarter) It is like reading a
manual to operate a machinery, and in every other paragraph it offers
the (technically-fantastically-correct) explanations of what bolt or
material were used where.

the cause of such nothingness situation is because the brainlessness
approach to doc organization coupled with standard computer industry
geeking moron's need to computer-sciency speak with implementation
infatuation. And in part it came to that really because they are
comparative morons.

for a more sincere, detailed account, please see:
http://xahlee.org/perl-python/re-write_notes.html

Thanks.

 Xah
 xah at xahlee.orghttp://xahlee.org/




More information about the Python-list mailing list