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

[R. David Murray]

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>
<http://bugs.python.org/issue22725>
_______________________________________