Path: csiph.com!usenet.pasdenom.info!weretis.net!feeder1.news.weretis.net!feeder.erje.net!eu.feeder.erje.net!newsfeed.freenet.ag!news2.euro.net!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.091 X-Spam-Evidence: '*H*': 0.82; '*S*': 0.00; 'subject:Python': 0.05; 'python': 0.09; 'attributes;': 0.16; 'from:addr:rosuav': 0.16; 'from:name:chris angelico': 0.16; 'janssen': 0.16; 'wed,': 0.16; 'wrote:': 0.17; 'feb': 0.19; 'doc': 0.22; "python's": 0.23; 'header:In-Reply-To:1': 0.25; 'am,': 0.27; 'restrict': 0.27; 'message-id:@mail.gmail.com': 0.27; 'all.': 0.28; "d'aprano": 0.29; 'search.': 0.29; 'steven': 0.29; 'no,': 0.29; "i'm": 0.29; 'url:python': 0.32; 'docs': 0.33; 'doubt': 0.33; 'to:addr:python- list': 0.33; 'knowledge': 0.33; '(with': 0.33; 'received:google.com': 0.34; 'replaced': 0.35; 'pm,': 0.35; 'received:209.85.220': 0.35; 'subject:?': 0.35; 'received:209.85': 0.35; 'but': 0.36; 'url:org': 0.36; 'should': 0.36; 'bad': 0.37; 'python.org': 0.37; 'quite': 0.37; 'received:209': 0.37; 'subject:: ': 0.38; 'mark': 0.38; 'url:docs': 0.38; 'sure': 0.38; 'gives': 0.39; 'to:addr:python.org': 0.39; 'google': 0.39; 'think': 0.40; 'most': 0.61; 'side': 0.61; 'results': 0.65; '26,': 0.65; 'search,': 0.65; 'biggest': 0.71; '2013': 0.84; 'not...': 0.84; 'strengths,': 0.84; 'subject:you': 0.88 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:x-received:in-reply-to:references:date:message-id :subject:from:to:content-type; bh=As3ruYLZh93KXGe7K5RdOvtjhdh0AIzV1D13NjjURKU=; b=obf6fPlUuiYwAICWU2HWOelM0hddI3VHlTrEE1vxdDKLEoKC8x82j3f3cNMvgqV1EK VcTHIskqHacF0sELQaOUiBz10HHKg5Kc6/VZL2jNxB9hshFWPPSUBe1BRVljColyzZcm wiGedF5RQVeJNwg9LzabbNuKPqoe8MyZx5LRh2fKnzdAUjDF6mAq+JS7dHdMtdg4CiB8 XyK/lW0lIp11UTjq/abt/3RkdIdxw9a+NC+i/PiZpyAZKZLXUyOOyLb/jPELsUrSSy6s 4rZrqFpRmwKiH7HYZMM7lK2qotMEI+NiB3FZ7eRfVcsiPlP+P1kcn3Jza0WynCcSZZnr U2Zw== MIME-Version: 1.0 X-Received: by 10.58.97.165 with SMTP id eb5mr152674veb.40.1361928710192; Tue, 26 Feb 2013 17:31:50 -0800 (PST) In-Reply-To: References: <512cb0a0$0$30001$c3e8da3$5496439d@news.astraweb.com> Date: Wed, 27 Feb 2013 12:31:50 +1100 Subject: Re: Do you feel bad because of the Python docs? From: Chris Angelico To: python-list@python.org Content-Type: text/plain; charset=ISO-8859-1 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: 22 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1361928719 news.xs4all.nl 6941 [2001:888:2000:d::a6]:40656 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:40019 On Wed, Feb 27, 2013 at 12:15 PM, Mark Janssen wrote: > On Tue, Feb 26, 2013 at 4:54 AM, Steven D'Aprano > wrote: >> >> There's no doubt that one of PHP's strengths, perhaps its biggest >> strength, is the good state of documentation. But should we feel bad >> about Python's docs? > > I don't think so at all. I think the python docs are quite well organized. > Who googles for python knowledge when you can just go to the official site > and use the doc search? I'm not sure if you're trolling or not... The python.org search is one of its weakest attributes; on the main http://python.org/ search, it's now been replaced by a Google site-search, but the box on the side in http://docs.python.org/ still gives the annoyingly slow internal search. So no, I don't go to the official site search, I use Google (with or without site:python.org to restrict the results - most often without). ChrisA