[docs] [issue22725] improve documentation for enumerate() (built-in function)

R. David Murray report at bugs.python.org
Sat Oct 25 07:14:20 CEST 2014

R. David Murray added the comment:

The existing documentation is technically correct, while your replacement leaves some things out, such as the fact that enumerate accepts an iteratable and returns an iterator that is specifically a special 'enumerate object'. (A sequence is an iteratable, but not all iterables sequences, and enumerate specifically does *not* return a list of pairs, and it is important to know that).

Can you explain what it is you find confusing about the existing documentation?  The examples should go a long way toward clarifying the text for those not familiar enough with the precisely correct terms it uses.

nosy: +r.david.murray

Python tracker <report at bugs.python.org>

More information about the docs mailing list