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

Groups > comp.lang.python > #81895

Re: Python docs disappointing

Show key headers only | View raw

On Thu, Dec 4, 2014 at 9:27 PM, Albert van der Horst
<albert@spenarnc.xs4all.nl> 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!
>
> Plain google is far superior in finding information.

Part of getting to know a language is learning what the best way to
find information about it is. When I want Pike documentation, I always
go direct to the docs (usually to my own build of them, to be sure
it'll match my locally-compiled Pike, so that's
http://sikorsky:8080/modref/index.html), but for most other languages,
it's better to use a web search. Sometimes your best result isn't the
official docs at all, but a StackOverflow post. Or maybe it's part of
the official docs, but not the module reference page (if you want to
know about argparse basics, the python.org howto is probably better
than the main page). As an added bonus, you don't need to "go here,
type this into search" - you just type what you want into your
browser's search box, or at very worst, pull up a link you probably
use a hundred times a day and will be cached.

> 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.

"The powers that be" implies that there's somebody else who is
obligated to provide a service to you. I don't think that's really the
case. That said, though, your other points are quite right; another
tutorial won't help, and improving search will help.

ChrisA

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