This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author anthony-flury
Recipients anthony-flury, docs@python, rhettinger
Date 2018-02-05.13:11:56
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1517836316.25.0.467229070634.issue32770@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2018-02-05 13:11:56anthony-flurysetrecipients: + anthony-flury, rhettinger, docs@python
2018-02-05 13:11:56anthony-flurysetmessageid: <1517836316.25.0.467229070634.issue32770@psf.upfronthosting.co.za>
2018-02-05 13:11:56anthony-flurylinkissue32770 messages
2018-02-05 13:11:56anthony-flurycreate