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 rschwieb
Recipients docs@python, rschwieb
Date 2015-03-31.13:56:02
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1427810162.43.0.413466648837.issue23823@psf.upfronthosting.co.za>
In-reply-to
Content
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 :)
History
Date User Action Args
2015-03-31 13:56:02rschwiebsetrecipients: + rschwieb, docs@python
2015-03-31 13:56:02rschwiebsetmessageid: <1427810162.43.0.413466648837.issue23823@psf.upfronthosting.co.za>
2015-03-31 13:56:02rschwieblinkissue23823 messages
2015-03-31 13:56:02rschwiebcreate