Do you feel bad because of the Python docs?

[Roy Smith]

In article <mailman.2541.1361884843.2939.python-list at python.org>,
 Chris Angelico <rosuav at gmail.com> wrote:

> There are some issues with the Googleability of the Python docs at the
> moment. It's much easier to find the official page of PHP's docs than
> Python's. Trouble is, the official page of PHP docs is a lot less
> helpful... like he says, it's in some cases flat-out wrong. And then
> you go read the comments underneath in the hope of learning what you
> need to know... and you find a pile of junk even worse than the main
> docs, but with the occasional useful gem so you can't dismiss it out
> of hand. (But it's buried among loads of code whose primary purpose is
> to explain why there's so much bad PHP code out there.)

Having lived through a year of PHP hell, I've developed a theory about 
the PHP ecosystem (i.e. docs, forums, user community, etc) vs. the 
Python ecosystem.

When people ask PHP questions, the questions tend to be phrased as "what 
do I type to get X", and the answers come back that way too.  The forums 
are full of, "I had the same problem.  Somebody told me to do this.  I 
don't really understand it, but it worked for me and maybe it'll work 
for you too".

The Python ecosystem is much more about understanding what's actually 
happening.