Python docs disappointing

[Michael Torrie]

On 12/04/2014 03:27 AM, Albert van der Horst wrote:
> That doesn't help. I'm a very experienced programmer and work in
> routinely a dozen languages. Sometimes I do python. I want to do
> numeric work. I remember the name numpy. It is important, everybody
> knows it, it is all over the place. So I want to find its docs,
> or some lead, whatever. I go to the official Python site,
> http://docs.python.org and type in numpy in the search machine.

> It is embarassing, try it!

That would indeed be embarrassing if numpy was a part of Python or had
anything to do with the python.org project.  In fact it doesn't.  It's a
third-party library for use with python.  As a beginner I would type in
"numpy" to google and see what happens.  Would you expect to go to
Microsoft MSDN to find information on a third-party library, such as,
say, SDL or Allegro, that you use in Visual Studio?

> Plain google is far superior in finding information.

Of course, since the information you are looking is third-party to
python.org for a start.

> And you tell me that writing yet another tutorial would improve that?
> No, there is just one way. The powers that be should look critically
> at their website, and test it with a beginners hat on.

Your ire is misplaced.  The GP was saying that if there is a deficiency
in the Python docs you can help fix that. If there's a deficiency in the
numpy docs, you can ask them about fixing that's what he means.