Author swanson
Recipients docs@python, martin.panter, nikratio, swanson
Date 2015-07-18.00:23:12
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1437178994.8.0.964101313373.issue24650@psf.upfronthosting.co.za>
In-reply-to
Content
Okay, interesting - I hadn't checked the glossary.  I don't ultimately care what it's called as long as the documentation is clear and consistent.  But for anyone just looking at the names of the classes and the class hierarchy, they'd come away saying, "A generator is a type of iterator," not "A generator is a type of function."  (Functions can't even have subtypes.)  If the docs are painting a different picture than the already existing reality, it seems like that would be confusing to anyone who doesn't already know how they work.  (If you already know how something works, you don't really need the docs, so it's easy to think they're clearer than they really are.)
History
Date User Action Args
2015-07-18 00:23:15swansonsetrecipients: + swanson, nikratio, docs@python, martin.panter
2015-07-18 00:23:14swansonsetmessageid: <1437178994.8.0.964101313373.issue24650@psf.upfronthosting.co.za>
2015-07-18 00:23:14swansonlinkissue24650 messages
2015-07-18 00:23:13swansoncreate