[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 Python-bugs-list mailing list