Message311666
Raymond,
I completely understand your comment but I do disagree.
My view would be that the documentation of the stdlib should document the entry level use cases.
The first example given uses nothing special from the Counter class - you could implement exactly the same with a defaultdict(int) - the only difference would be that output will read defaultdict(<type 'int'>,{'blue': 3, 'red': 2, 'green': 1}).
I think the examples in the documentation should at least demonstrate something important on the class being documented - and the first example doesn't.
I am very tempted to re-open - but I wont - no benefit in bouncing the status as we discuss this. |
|
Date |
User |
Action |
Args |
2018-02-05 13:11:56 | anthony-flury | set | recipients:
+ anthony-flury, rhettinger, docs@python |
2018-02-05 13:11:56 | anthony-flury | set | messageid: <1517836316.25.0.467229070634.issue32770@psf.upfronthosting.co.za> |
2018-02-05 13:11:56 | anthony-flury | link | issue32770 messages |
2018-02-05 13:11:56 | anthony-flury | create | |
|