Path: csiph.com!usenet.pasdenom.info!aioe.org!news.stack.nl!newsfeed.xs4all.nl!newsfeed3.news.xs4all.nl!xs4all!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail Return-Path: X-Original-To: python-list@python.org Delivered-To: python-list@mail.python.org X-Spam-Status: OK 0.000 X-Spam-Evidence: '*H*': 1.00; '*S*': 0.00; 'python.': 0.02; 'programmer': 0.03; 'tutorial': 0.03; 'languages.': 0.04; 'third- party': 0.04; 'beginner': 0.05; 'say,': 0.05; 'that?': 0.05; 'subject:Python': 0.06; 'important,': 0.07; 'beginners': 0.09; 'happens.': 0.09; 'lead,': 0.09; 'whatever.': 0.09; 'python': 0.11; 'from:addr:torriem': 0.16; 'from:name:michael torrie': 0.16; 'means.': 0.16; 'numpy': 0.16; 'routinely': 0.16; 'fix': 0.17; 'wrote:': 0.18; 'library': 0.18; 'help.': 0.21; 'saying': 0.22; 'header:User-Agent:1': 0.23; 'library,': 0.24; 'van': 0.27; 'header:In-Reply-To:1': 0.27; 'am,': 0.29; "doesn't": 0.30; "i'm": 0.30; 'work.': 0.31; 'that.': 0.31; 'fixing': 0.31; 'python.org': 0.32; 'another': 0.32; 'url:python': 0.33; 'plain': 0.33; 'knows': 0.35; 'no,': 0.35; 'test': 0.35; 'google': 0.35; 'there': 0.35; 'machine.': 0.36; 'subject:skip:d 10': 0.36; 'url:org': 0.36; 'should': 0.36; 'sometimes': 0.38; 'message-id:@gmail.com': 0.38; 'hat': 0.38; 'to:addr:python-list': 0.38; 'fact': 0.38; 'anything': 0.39; 'expect': 0.39; 'visual': 0.39; 'to:addr:python.org': 0.39; 'received:org': 0.40; 'everybody': 0.60; 'tell': 0.60; 'information': 0.63; 'name': 0.63; 'such': 0.63; 'it!': 0.67; 'superior': 0.69; 'start.': 0.84; 'albert': 0.91; 'critically': 0.91; 'dozen': 0.91 X-Virus-Scanned: amavisd-new at torriefamily.org Date: Thu, 04 Dec 2014 16:57:31 -0700 From: Michael Torrie User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20131118 Thunderbird/17.0.11 MIME-Version: 1.0 To: python-list@python.org Subject: Re: Python docs disappointing References: <77d357fb-342e-4856-814d-0e0003164fb1@googlegroups.com> <5480371a$0$15841$e4fe514c@dreader35.news.xs4all.nl> In-Reply-To: <5480371a$0$15841$e4fe514c@dreader35.news.xs4all.nl> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-BeenThere: python-list@python.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: General discussion list for the Python programming language List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Newsgroups: comp.lang.python Message-ID: Lines: 30 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1417737462 news.xs4all.nl 2889 [2001:888:2000:d::a6]:44312 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:81963 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.