[docs] [issue23823] "Generalization" misused in deque docs
rschwieb
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
components: Documentation
messages: 239710
nosy: docs at python, rschwieb
priority: normal
severity: normal
status: open
title: "Generalization" misused in deque docs
type: enhancement
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>
<http://bugs.python.org/issue23823>
_______________________________________
More information about the docs
mailing list