This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author wolma
Recipients Jim Fasarakis-Hilliard, docs@python, marco.buttu, rhettinger, terry.reedy, wolma
Date 2017-02-28.16:18:16
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1488298697.58.0.865997701712.issue29414@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2017-02-28 16:18:17wolmasetrecipients: + wolma, rhettinger, terry.reedy, docs@python, marco.buttu, Jim Fasarakis-Hilliard
2017-02-28 16:18:17wolmasetmessageid: <1488298697.58.0.865997701712.issue29414@psf.upfronthosting.co.za>
2017-02-28 16:18:17wolmalinkissue29414 messages
2017-02-28 16:18:17wolmacreate