Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.lang.python > #81963

Re: Python docs disappointing

Show all headers | View raw

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.

Back to comp.lang.python | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

Re: Python docs disappointing jstnms123@gmail.com - 2014-11-20 07:54 -0800
  Re: Python docs disappointing Joel Goldstick <joel.goldstick@gmail.com> - 2014-11-20 11:51 -0500
    Re: Python docs disappointing albert@spenarnc.xs4all.nl (Albert van der Horst) - 2014-12-04 10:27 +0000
      Re: Python docs disappointing Chris Angelico <rosuav@gmail.com> - 2014-12-04 21:37 +1100
      Re: Python docs disappointing Steven D'Aprano <steve+comp.lang.python@pearwood.info> - 2014-12-04 22:46 +1100
      Re: Python docs disappointing jtan <admin@grails.asia> - 2014-12-05 07:33 +0800
      Re: Python docs disappointing Michael Torrie <torriem@gmail.com> - 2014-12-04 16:57 -0700
  Re: Python docs disappointing Michael Torrie <torriem@gmail.com> - 2014-11-20 09:51 -0700
  Re: Python docs disappointing Skip Montanaro <skip.montanaro@gmail.com> - 2014-11-20 11:18 -0600
  Re: Python docs disappointing Grant Edwards <invalid@invalid.invalid> - 2014-11-20 23:10 +0000
    Re: Python docs disappointing Mark Lawrence <breamoreboy@yahoo.co.uk> - 2014-11-20 23:22 +0000
  Re: Python docs disappointing Steven D'Aprano <steve+comp.lang.python@pearwood.info> - 2014-11-21 10:29 +1100
    Re: Python docs disappointing Grant Edwards <invalid@invalid.invalid> - 2014-11-21 16:35 +0000

csiph-web