Path: csiph.com!usenet.pasdenom.info!weretis.net!feeder1.news.weretis.net!feeder.erje.net!eu.feeder.erje.net!xlned.com!feeder3.xlned.com!newsfeed.xs4all.nl!newsfeed1.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; 'tutorial': 0.03; 'argument': 0.05; 'subject:Python': 0.06; 'pep': 0.09; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'python': 0.11; 'jan': 0.12; 'suggest': 0.14; 'mostly': 0.14; 'lambda': 0.16; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'reedy': 0.16; 'sat,': 0.16; 'wrote:': 0.18; 'passing': 0.19; 'examples': 0.20; 'programming': 0.22; 'aug': 0.22; 'header:User- Agent:1': 0.23; 'example.': 0.24; 'forms.': 0.24; 'header:X -Complaints-To:1': 0.27; 'header:In-Reply-To:1': 0.27; 'function': 0.29; 'appear': 0.29; 'specifically': 0.29; 'url:bugs': 0.29; "doesn't": 0.30; 'programming.': 0.30; 'end,': 0.31; 'figure': 0.32; 'another': 0.32; 'url:python': 0.33; 'subject:the': 0.34; 'could': 0.34; 'subject:skip:d 10': 0.36; 'subject:?': 0.36; 'url:org': 0.36; 'should': 0.36; 'clear': 0.37; 'to:addr:python- list': 0.38; 'pm,': 0.38; 'does': 0.39; 'functional': 0.39; 'use.': 0.39; 'to:addr:python.org': 0.39; 'received:org': 0.40; 'url:3': 0.61; 'received:173': 0.61; 'back': 0.62; 'improvement.': 0.68; 'received:fios.verizon.net': 0.84; 'subject:Where': 0.84; 'subject:official': 0.84; 'joel': 0.91; '2013': 0.98 X-Injected-Via-Gmane: http://gmane.org/ To: python-list@python.org From: Terry Reedy Subject: Re: Where to suggest improvements in the official Python documentation? Date: Sat, 03 Aug 2013 16:43:14 -0400 References: 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/20130620 Thunderbird/17.0.7 In-Reply-To: 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: 1375562619 news.xs4all.nl 15865 [2001:888:2000:d::a6]:36800 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:51887 On 8/3/2013 2:23 PM, Joel Goldstick wrote: > On Sat, Aug 3, 2013 at 1:53 PM, Aseem Bansal > wrote: >> I have a suggestion about the Python tutorial for improvement. >> Specifically about in Python tutorial 4.7.5 lambda forms. >> http://docs.python.org/3/tutorial/controlflow.html#lambda-forms >> >> It is not very clear from the tutorial what lambda forms are for They are mostly for passing a one-use function as an argument to another function. The tutorial should say that and give an example. http://bugs.python.org/issue18646 >> someone who doesn't know functional programming. I think placing a >> link of "functional Programming HOWTO" of Python documentation can >> take out much confusion for Python newbies. That document is not about lambda. The word 'lambda' does not appear until near the end, and some of the current examples violate PEP 8. >> I would like to suggest this because as I newbiw I had much >> confusion 2 months back before I could figure out its proper use. >> Where do I suggest this improvement? -- > http://docs.python.org/2/bugs.html -- Terry Jan Reedy