Path: csiph.com!v102.xanadu-bbs.net!xanadu-bbs.net!goblin3!goblin.stu.neva.ru!news.tu-darmstadt.de!news.internetdienste.de!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.011 X-Spam-Evidence: '*H*': 0.98; '*S*': 0.00; 'subject:Python': 0.05; 'versions,': 0.05; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'terry': 0.09; 'agreements.': 0.16; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'reedy': 0.16; 'wrote:': 0.17; 'thorough': 0.17; 'jan': 0.18; 'discussion': 0.20; 'changes': 0.20; 'tracker': 0.20; 'doc': 0.22; 'changes,': 0.23; 'header:In- Reply-To:1': 0.25; 'header:User-Agent:1': 0.26; 'ago': 0.27; 'opposed': 0.27; 'header:X-Complaints-To:1': 0.28; 'probably': 0.29; 'ease': 0.30; 'asking': 0.32; 'could': 0.32; 'getting': 0.33; 'to:addr:python-list': 0.33; 'likely': 0.33; 'whatever': 0.35; 'ahead': 0.35; 'pm,': 0.35; 'subject:?': 0.35; 'received:org': 0.36; 'but': 0.36; "i'll": 0.36; 'subject:: ': 0.38; 'some': 0.38; 'to:addr:python.org': 0.39; 'notice': 0.39; 'header:Received:5': 0.40; 'skip:n 10': 0.63; 'more': 0.63; 'benefit': 0.70; 'online': 0.70; 'sounds': 0.71; 'received:fios.verizon.net': 0.84; 'subject:you': 0.88; 'bob': 0.91; 'serious': 0.98 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: Sat, 09 Mar 2013 01:22:39 -0500 References: <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> <3cblj891u465s49s08doriof23udqlr0ai@4ax.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: <3cblj891u465s49s08doriof23udqlr0ai@4ax.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: 25 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1362810185 news.xs4all.nl 6884 [2001:888:2000:d::a6]:33095 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:40934 On 3/8/2013 11:12 PM, Bob Hanson wrote: > I do notice trivial changes, I am currently set up again to do doc changes, so if you already have some non-controversial changes to the *current* docs, the online html versions, go ahead and email them to me. > but I also feel some of the > documentation could benefit from a much more thorough general > editing to improve both ease of reading and general clarity. Big edits will need discussion on the tracker and will likely be opposed by someone. > Contributing in this way sounds like I'll want to get more > involved and probably do the contributor-signing thing and such > -- or whatever steps I need to follow. Please do the agreement thing now. We just added the e-form a week ago and with that are getting more serious about asking for the agreements. -- Terry Jan Reedy