[issue20402] List comprehensions should be noted in for loop documentation

2014-08-04 Thread Ezio Melotti
Changes by Ezio Melotti ezio.melo...@gmail.com: -- stage: needs patch - resolved ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue20402 ___ ___

[issue20402] List comprehensions should be noted in for loop documentation

2014-08-03 Thread Rob Lanphier
Rob Lanphier added the comment: Moving it earlier in the tutorial is likely to do more harm than help. In teaching Python, you need some gap between learning for-loops and learning list comprehensions (the former is a prerequisite for the latter). The problem here is that many people get

[issue20402] List comprehensions should be noted in for loop documentation

2014-08-03 Thread Raymond Hettinger
Raymond Hettinger added the comment: Sorry, I'm going to close this one because I believe it would make the documentation worse. I don't believe that making a forward reference from section 4.2 to section 5.6 helps anyone. -- resolution: - rejected status: open - closed

[issue20402] List comprehensions should be noted in for loop documentation

2014-08-02 Thread Alexander Grigorievskiy
Alexander Grigorievskiy added the comment: I have added some clarification following Westley Martínez recommendation. I provided references to the list comprehensions and generator expressions. I tried to make the description short. -- keywords: +patch nosy: +AlexGrig Added file:

[issue20402] List comprehensions should be noted in for loop documentation

2014-08-02 Thread Raymond Hettinger
Raymond Hettinger added the comment: We do have prominent entries in the glossary and tutorial: https://docs.python.org/2.7/glossary.html#term-list-comprehension https://docs.python.org/2.7/tutorial/datastructures.html#list-comprehensions Moving it earlier in the tutorial is likely to do more

[issue20402] List comprehensions should be noted in for loop documentation

2014-02-17 Thread Westley Martínez
Westley Martínez added the comment: I'm curious what the best way to do this would be. Obviously the simplest would just be 'See also list comprehensions.' However since this is a tutorial, I was thinking of adding something like this: 'In other languages, for loops are often used to fill a

[issue20402] List comprehensions should be noted in for loop documentation

2014-02-15 Thread Ezio Melotti
Changes by Ezio Melotti ezio.melo...@gmail.com: -- keywords: +easy nosy: +ezio.melotti stage: - needs patch versions: +Python 2.7, Python 3.3, Python 3.4, Python 3.5 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue20402

[issue20402] List comprehensions should be noted in for loop documentation

2014-01-26 Thread Rob Lanphier
New submission from Rob Lanphier: The current list comprehension documentation is difficult to find for someone who doesn't know what a list comprehension is. Example of this problem: http://www.reddit.com/r/learnprogramming/comments/1w6slm/different_kind_of_for_loop_python/ Since list