Message288718
I studied the github PR and thought about it carefully, and that made me come to believe that the chapter deserves a larger rewrite not just of one section, but of several.
I'm attaching my proposed change as a "classical" patch here for discussion. I hope that's still a valid way to do this as I did not want to mess with the original PR by Marco and, instead, wanted to see my proposal discussed first.
Some of the changes I made:
- I don't think range() really deserves its own section in a chapter about control flow, so I removed most of it and linked to the relevant stdtypes section instead
- moved the definition of an iterable up into the for loop section
- restructured the for loop section to discuss Python for loops first and only compare them to Pascal/C afterwards
- moved the example for modifying a list while iterating over it to the datastructures chapter
I find this new version much clearer, but lets see what people here think. |
|
Date |
User |
Action |
Args |
2017-02-28 16:18:17 | wolma | set | recipients:
+ wolma, rhettinger, terry.reedy, docs@python, marco.buttu, Jim Fasarakis-Hilliard |
2017-02-28 16:18:17 | wolma | set | messageid: <1488298697.58.0.865997701712.issue29414@psf.upfronthosting.co.za> |
2017-02-28 16:18:17 | wolma | link | issue29414 messages |
2017-02-28 16:18:17 | wolma | create | |
|