Message170785
The documentation of timeit can be improved in several ways:
* it should start with a couple of short and comprehensible examples that show the basic usage from the command-line and from the code;
* the 3 convenience functions should be moved before the class documentation (and their order inverted);
* the methods in the class should be reordered to show the important one first;
* more comprehensive (but still comprehensible) examples should be added at the end;
* sh syntax highlight should be used for the command-line usage examples;
* the note about Python 2.3 can be removed from 3.x docs;
http://docs.python.org/dev/library/timeit.html |
|
Date |
User |
Action |
Args |
2012-09-20 03:26:47 | ezio.melotti | set | recipients:
+ ezio.melotti, docs@python |
2012-09-20 03:26:47 | ezio.melotti | set | messageid: <1348111607.58.0.268885940785.issue15979@psf.upfronthosting.co.za> |
2012-09-20 03:26:47 | ezio.melotti | link | issue15979 messages |
2012-09-20 03:26:46 | ezio.melotti | create | |
|