[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.
Python tracker <report at bugs.python.org>
More information about the docs