Raymond Hettinger added the comment:

> I did find it somewhat confusing when trying to interpret 
> the timeit documentation.

Perhaps that is a good thing.  Making good, repeatable, meaningful timings  
where you have a clear interpretation of the results is non-trivial, learned 
skill.   Cross-checking results and explaining differences are fundamental 
skills.  There is really no reason the docs should try to make it look easier 
that it really is (running the tool is easy, but interpreting results sometimes 
isn't).

> Being a somewhat pedantic and trivial patch, I'm fine if you 
> want to close it wontfix.

That is reasonable.  I don't that this has caused any actual impediment to 
learning how to use timeit.  The docs have been somewhat successful in that 
regard.

----------
nosy: +rhettinger

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue18588>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to