See:
- https://docs.python.org/3.6/library/typing.html#typing.Deque
- https://docs.python.org/3.5/library/typing.html#typing.Deque

`typing.Deque` is expected to be included in 3.6.1:
https://docs.python.org/3/whatsnew/changelog.html#python-3-6-1-release-candidate-1

Please remove or specify the version in which it's going to be included.

The online docs are regenerated daily from the current repository, so the inclusion of typing.Deque in the doc is correct, given that it has been added to the module.  IDLE aside, new features in bugfix releases are limited to provisional modules, such as typing.  I believe this should get a 'New in 3.6.1' (or 3.5.?) note.

Some installations include a local frozen copy of the docs.  The frozen copy will not include the rare (and admittedly confusing) feature added for a future release.  But it will also not include the much more common corrections and clarifications added since the release.

I agree this is very confusing (and in fact confused me for about an hour between getting import errors, double checking the docs, checking I was in the right env, double checking the docs, checking the source of my env, double checking the docs, checking the git source and then tracking through these too issues).

Yes, we should put versionadded in the docs to augment the MISC/NEWS entries.

Mariatta, do you want to take a crack at the patch?  It should hit both 3.5 and 3.6 docs.

Thanks, Raymond :) I prepared the pull requests for 3.5, 3.6, and master branches.

Thomas, you mentioned about needing to go over CLA with your employer in your PR.

Not sure if you have any update on that? If your CLA is approved, I can merge and cherry-pick your PR instead.

I am not optimistic about the speed at which my employer will get this
sorted out.

better to just fix it and drop my commit!

On Tue, Feb 14, 2017, 23:43 Mariatta Wijaya <report@bugs.python.org> wrote:

Mariatta Wijaya added the comment:

Thanks, Raymond :) I prepared the pull requests for 3.5, 3.6, and master
branches.

Thomas, you mentioned about needing to go over CLA with your employer in
your PR.

Not sure if you have any update on that? If your CLA is approved, I can
merge and cherry-pick your PR instead.

----------
stage:  -> patch review

_______________________________________
Python tracker <report@bugs.python.org>
<http://bugs.python.org/issue29481>
_______________________________________

Thanks, Thomas :) I'll let you close your own PR on GitHub.

New changeset 36da1c3589e1bc4246cccf6bd0094a110416a43a by GitHub in branch 'master':
bpo-29481: add versionadded 3.6.1 to typing.Deque docs (#107)
https://github.com/python/cpython/commit/36da1c3589e1bc4246cccf6bd0094a110416a43a

New changeset 7224a049b88ed37c510861528147e0db54911bb7 by GitHub in branch '3.6':
bpo-29481: add versionadded 3.6.1 to typing.Deque docs (#108)
https://github.com/python/cpython/commit/7224a049b88ed37c510861528147e0db54911bb7

New changeset bb53a27a5d56a4f33c3fc8eebb486b34808c92b7 by GitHub in branch '3.5':
[cherry-pick for 3.5] bpo-29481: add versionadded 3.5.4 to typing.Deque docs (#109)
https://github.com/python/cpython/commit/bb53a27a5d56a4f33c3fc8eebb486b34808c92b7

Merged and backported to 3.5 and 3.6.

Thanks all :)