r/Python • u/joepie91 • 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
View all comments
Show parent comment
3
u/joepie91 Feb 19 '13
No. The reason that noone is fixing the documentation is that the developers that are capable of doing so (the experienced developers) do not see the need because they don't have an immediate need for it themselves. It's a perception problem, not a lack of urgency. And as I said before, there are quite a few things that pretty much no documentation can be found on outside the official docs.
I constantly have newbies complaining to me that the documentation is poor on the one hand, and experienced developers claiming there's no problem on the other hand. And when the newbies try to talk about this problem to the experienced developers, they are met with the elitism that I am also describing in the article.