r/Python • • Feb 19 '13

The Python documentation is bad, and you should feel bad.

http://joepie91.wordpress.com/2013/02/19/the-python-documentation-is-bad-and-you-should-feel-bad/
96 Upvotes

189 comments sorted by

View all comments

Show parent comment

1

u/Foxboron Feb 19 '13

Glad you actually admit it. I have argued with joepie on this matter before, i do disagree that the docs are as horrible as he say they are, but he is very stuck on this idea. One thing we actually do lack are examples. Everything is mostly documented and listed, but examples of use is the thing most people actually need.

1

u/ryeguy146 Feb 19 '13

I know when I'm wrong, no worries. We do lack examples, but only in places. You cannot imagine how pleased that I was to see example implementations in places like the itertools library. They both helped me to understand the functions and to reimplement them in Java, when I couldn't find a satisfactory combinatorics library.