Path: csiph.com!usenet.pasdenom.info!weretis.net!feeder4.news.weretis.net!nuzba.szn.dk!pnx.dk!news.stack.nl!newsfeed.xs4all.nl!newsfeed3.news.xs4all.nl!xs4all!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.002 X-Spam-Evidence: '*H*': 1.00; '*S*': 0.00; 'subject:Python': 0.05; 'context': 0.05; 'ok.': 0.07; 'python': 0.09; 'page?': 0.09; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'terry': 0.09; 'bug': 0.10; 'bugs,': 0.16; 'describing': 0.16; 'did.': 0.16; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'reedy': 0.16; 'sees': 0.16; 'selects': 0.16; 'wrote:': 0.17; 'fix': 0.17; 'jan': 0.18; '(or': 0.18; 'proposed': 0.20; 'doc': 0.22; 'wednesday,': 0.22; 'posted': 0.22; 'patch': 0.24; 'idea': 0.24; 'script': 0.24; 'allows': 0.25; 'header:In-Reply-To:1': 0.25; 'header:User-Agent:1': 0.26; 'developers': 0.26; 'bugs': 0.27; 'propose': 0.27; 'header:X-Complaints-To:1': 0.28; 'went': 0.28; 'reporting': 0.29; 'writes': 0.30; 'gets': 0.32; 'url:python': 0.32; 'johnson': 0.32; 'suggestion': 0.32; 'text,': 0.33; 'to:addr:python-list': 0.33; 'entry': 0.33; 'version': 0.34; 'text': 0.34; 'pm,': 0.35; 'subject:?': 0.35; 'next': 0.35; 'received:org': 0.36; 'but': 0.36; 'url:org': 0.36; 'email addr:python.org': 0.36; 'python.org': 0.37; 'well.': 0.37; 'subject:: ': 0.38; 'easier': 0.38; 'some': 0.38; 'url:docs': 0.38; 'page': 0.38; 'to:addr:python.org': 0.39; 'takes': 0.39; 'where': 0.40; 'header:Received:5': 0.40; 'more.': 0.62; 'great': 0.64; 'here': 0.65; 'box.': 0.65; 'readers': 0.65; 'home': 0.66; 'click': 0.76; '2013': 0.84; 'received:fios.verizon.net': 0.84; 'subject:you': 0.88; 'info,': 0.91; 'rick': 0.91 X-Injected-Via-Gmane: http://gmane.org/ To: python-list@python.org From: Terry Reedy Subject: Re: Do you feel bad because of the Python docs? Date: Wed, 06 Mar 2013 20:52:59 -0500 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> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Gmane-NNTP-Posting-Host: pool-173-75-251-66.phlapa.fios.verizon.net User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/20130215 Thunderbird/17.0.3 In-Reply-To: <2d3eea1e-db12-4448-80b3-2743866a2d42@googlegroups.com> 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: 38 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1362621202 news.xs4all.nl 6844 [2001:888:2000:d::a6]:42456 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:40686 On 3/6/2013 7:47 PM, Rick Johnson wrote: > On Wednesday, March 6, 2013 5:50:35 PM UTC-6, Terry Reedy wrote: > >> If you find a bug in this documentation or would like to propose an >> improvement, please send an e-mail to docs@python.org describing the bug >> and where you found it. If you have a suggestion how to fix it, include >> that as well. > > That's great Terry, but how will the next person find the link? The same way I did. Go to http://docs.python.org/3/ (or /2/ and click on Reporting bugs, which takes one to the above and more. > I went to Python.org and i did not see it on the home page, nor the doc page... Which doc page? > How much longer are we going to "treat the symptoms" We would VERY MUCH like a system to make it easier for readers to report doc bugs and developers to fix them. No one yet has come up with both a reasonable idea and workable implementation. Here is an idea I just came up with. *Someone* writes javascript that allows the following: Reader using the web version sees a mistake, selects some text with the mistake, right clicks, selects 'Suggest correction', gets a box or form with the selected text, page and location or context info, and a text entry box. Reader enters correction in text box and clicks OK. Message is emailed or posted to python.org. *Someone* writes a python script to process reports by generating a proposed patch for human review. -- Terry Jan Reedy