Path: csiph.com!usenet.pasdenom.info!weretis.net!feeder4.news.weretis.net!ecngs!feeder2.ecngs.de!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.107 X-Spam-Level: * X-Spam-Evidence: '*H*': 0.79; '*S*': 0.00; 'subject:Python': 0.05; 'links.': 0.09; '"about': 0.16; 'fix,': 0.16; 'users.': 0.16; 'wed,': 0.16; 'wrote:': 0.17; 'email addr:gmail.com>': 0.20; 'to:name:python-list@python.org': 0.20; 'all,': 0.21; 'fairly': 0.21; 'minor': 0.22; '>': 0.23; 'second': 0.24; 'tried': 0.25; 'header:In-Reply-To:1': 0.25; 'am,': 0.27; 'message- id:@mail.gmail.com': 0.27; 'chris': 0.28; 'feature,': 0.29; 'searches': 0.29; 'url:mailman': 0.29; 'skip:_ 10': 0.29; 'skip:& 10': 0.29; 'call.': 0.30; 'window': 0.30; '(and': 0.32; 'url:python': 0.32; 'generally': 0.32; 'good.': 0.32; 'johnson': 0.32; 'could': 0.32; 'url:listinfo': 0.32; 'page.': 0.33; 'scroll': 0.33; 'to:addr:python-list': 0.33; 'likely': 0.33; 'that,': 0.34; 'received:google.com': 0.34; 'pm,': 0.35; 'subject:?': 0.35; 'received:209.85': 0.35; 'next': 0.35; 'but': 0.36; 'url:org': 0.36; "didn't": 0.36; 'useful': 0.36; 'unable': 0.36; 'why': 0.37; 'received:209': 0.37; 'subject:: ': 0.38; 'page': 0.38; 'to:addr:python.org': 0.39; 'url:mail': 0.40; 'think': 0.40; 'bottom': 0.60; 'link': 0.60; 'most': 0.61; 'first': 0.61; 'more': 0.63; 'show': 0.63; 'making': 0.64; 'great': 0.64; 'results': 0.65; 'obvious': 0.71; 'low': 0.83; '2013': 0.84; 'way)': 0.84; 'subject:you': 0.88; 'rick': 0.91 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=x-received:mime-version:in-reply-to:references:from:date:message-id :subject:to:content-type:x-gm-message-state; bh=3Q8pzrKV4nRIqv028SnJbC5KHXb9cPhAFxgMg2Yk+Jg=; b=L2NHw93QLlnuKV8PdJee/j3Sd9h1Hew4dFRUWkpDP9h6iCDaBgs4I4UHeImwYoh7WJ ne0T9Y9QiXsBk9VcH9eybhDetGAYLk6lEaY2ktdvY/WsMMEbDK3nE6fkQAM2DvVVqt7A R+xM07Ryojmn+Gsquvu7jGBBOV7KjNP4xgMPFXrImOfhd3TehD+ytVgIBoHWfrCmYGjB H/vomLgTBEJdhARD7nox0/pD/TGdZ97Pamfvojx6zU2gio9bwlmnezLuuLXStc5o/qIh Z8Z8VY3PiuIgqpyZLF6f+lLrcI+wzzHa1+np4+cmj3Ay+QUeymk7XxdmiUnlOGbasdKg vOGw== X-Received: by 10.49.118.38 with SMTP id kj6mr51817566qeb.53.1362619711353; Wed, 06 Mar 2013 17:28:31 -0800 (PST) MIME-Version: 1.0 In-Reply-To: <857d97ed-7c86-43c9-9751-9728652ac122@hd10g2000pbc.googlegroups.com> References: <512cb0a0$0$30001$c3e8da3$5496439d@news.astraweb.com> <57fd0b09-b30d-4e62-845a-aac198113a40@googlegroups.com> <54967758-e84c-4b9c-a09c-10fbdbec230f@googlegroups.com> <63b306c9-db6f-4c4c-b3c6-4c602ba31201@kt16g2000pbb.googlegroups.com> <20130306114842.c0da03f1ba6a3c99d429f3a8@lavabit.com> <2d3eea1e-db12-4448-80b3-2743866a2d42@googlegroups.com> <857d97ed-7c86-43c9-9751-9728652ac122@hd10g2000pbc.googlegroups.com> From: Chris Kaynor Date: Wed, 6 Mar 2013 17:28:10 -0800 Subject: Re: Do you feel bad because of the Python docs? To: "python-list@python.org" Content-Type: multipart/alternative; boundary=047d7b6d89e8dc51e204d74b9ffa X-Gm-Message-State: ALoCoQmp/IevdVCchnULbvrwh6zJMbCrey34AxxTOeIppUtTwiZ2JyA0f0njvCuk9oXmJVnamrxJ 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: 78 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1362619713 news.xs4all.nl 6879 [2001:888:2000:d::a6]:32991 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:40682 --047d7b6d89e8dc51e204d74b9ffa Content-Type: text/plain; charset=ISO-8859-1 I actually just tried that, and the results weren't very good. Using the doc's search feature, the "Reporting Bugs" (and the "About these documents") page was significantly down the page (about 2/3 of the way) - not the most obvious result in the pile. All the other searches I could think of either didn't return either of those pages at all, or they were also 1/2-2/3 of the way down the page. The link is also on the main documentation page, but it is, again, near the bottom, making it hidden from many users. Both of them show up just above the bottom of the window with it maximized on my screen. The first of the issues may be difficult to fix, but would likely be fairly useful - that would generally be my first port of call. The second one is more minor as most people will scroll down to see whats farther down, if they go to the main page to find the links. Chris On Wed, Mar 6, 2013 at 5:06 PM, alex23 wrote: > On Mar 7, 10:47 am, Rick Johnson wrote: > > That's great Terry, but how will the next person find the link? > > Why do you have such a low opinion of others that you think they're > unable to look up "Reporting Bugs" in the _documentation_? > -- > http://mail.python.org/mailman/listinfo/python-list > --047d7b6d89e8dc51e204d74b9ffa Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable
I actually just tried that, and the results weren't ve= ry good.

Using the doc's search feature, the &= quot;Reporting Bugs" (and the "About these documents") page = was=A0significantly=A0down the page (about 2/3 of the way) - not the most o= bvious result in the pile. All the other searches I could think of either d= idn't return either of those pages at all, or they were also 1/2-2/3 of= the way down the page.

The link is also on the main documentation = page, but it is, again, near the bottom, making it hidden from many users. = Both of them show up just above the bottom of the window with it maximized = on my screen.

The first of the issues may be difficult to= fix, but would likely be fairly useful - that would generally be my first = port of call. The second one is more minor as most people will scroll down = to see whats farther down, if they go to the main page to find the links.

Chris


On Wed, Mar 6, 2013 at 5:06 PM, alex23 <= span dir=3D"ltr"><wuwei23@gmail.com> wrote:
On Mar 7, 10:47=A0am, Rick Johnson <rantingrickjohn...@gmail.com> wrote: > That's great Terry, but how will the next person find the link?
Why do you have such a low opinion of others that you think they'= re
unable to look up "Reporting Bugs" in the _documentation_?
--
http://mail.python.org/mailman/listinfo/python-list

--047d7b6d89e8dc51e204d74b9ffa--