[New-bugs-announce] [issue23823] "Generalization" misused in deque docs
report at bugs.python.org
Tue Mar 31 15:56:02 CEST 2015
New submission from rschwieb:
This sentence in the deque docs (https://docs.python.org/2/library/collections.html#collections.deque) is not accurate:
"Deques are a generalization of stacks and queues ..."
Deques are a _specialization_ of stacks and queues. Every deque is-a stack and is-a queue, but saying that "deques generalize stacks and queues" reverses this relationship.
On the surface it might seem minor, but I think it's worth correcting in this case since the "is-a" relationship is so fundamental in computer science. Besides, I'd like to think Python's awesome documentation is above using words to mean the opposite of what they mean :)
assignee: docs at python
nosy: docs at python, rschwieb
title: "Generalization" misused in deque docs
versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4, Python 3.5, Python 3.6
Python tracker <report at bugs.python.org>
More information about the New-bugs-announce