[issue46494] Mention typing_extensions in the typing documentation

[miss-islington]

miss-islington  added the comment:


New changeset 0c718e02f60f98275c62e8a2a152f086650e88ea by Miss Islington (bot) 
in branch '3.9':
bpo-46494: Mention the typing_extensions pkg in typing docs (GH-31260)
https://github.com/python/cpython/commit/0c718e02f60f98275c62e8a2a152f086650e88ea


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46494] Mention typing_extensions in the typing documentation

[miss-islington]

miss-islington  added the comment:


New changeset e053f0e9f41791095a924e2aceaaa025a058ed57 by Miss Islington (bot) 
in branch '3.10':
bpo-46494: Mention the typing_extensions pkg in typing docs (GH-31260)
https://github.com/python/cpython/commit/e053f0e9f41791095a924e2aceaaa025a058ed57


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46494] Mention typing_extensions in the typing documentation

[miss-islington]

Change by miss-islington :


--
pull_requests: +29863
pull_request: https://github.com/python/cpython/pull/31747

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46494] Mention typing_extensions in the typing documentation

[miss-islington]

Change by miss-islington :


--
nosy: +miss-islington
nosy_count: 7.0 -> 8.0
pull_requests: +29862
pull_request: https://github.com/python/cpython/pull/31746

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46494] Mention typing_extensions in the typing documentation

[Jelle Zijlstra]

Jelle Zijlstra  added the comment:

Thanks for the patch!

--
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46494] Mention typing_extensions in the typing documentation

[Jelle Zijlstra]

Jelle Zijlstra  added the comment:


New changeset 8debeed3075bf4d7e568e65da16bec63cf276f4f by Meer Suri in branch 
'main':
bpo-46494: Mention the typing_extensions pkg in typing docs (GH-31260)
https://github.com/python/cpython/commit/8debeed3075bf4d7e568e65da16bec63cf276f4f


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46494] Mention typing_extensions in the typing documentation

[Meer Suri]

Change by Meer Suri :


--
keywords: +patch
pull_requests: +29426
stage:  -> patch review
pull_request: https://github.com/python/cpython/pull/31260

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46494] Mention typing_extensions in the typing documentation

[Jelle Zijlstra]

Jelle Zijlstra  added the comment:

Welcome to this project, Meer!

That looks pretty good, feel free to submit a PR. We can then perhaps get 
feedback from more people to improve the wording.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46494] Mention typing_extensions in the typing documentation

[Meer Suri]

Meer Suri  added the comment:

(First time contributor looking for guidance) Is this diff okay? I'm not sure 
if the package name should be typing-extensions, or if the formatting is okay

diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index 94a46b01a1..c0fe656c1c 100644
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -32,6 +32,11 @@ In the function ``greeting``, the argument ``name`` is 
expected to be of type
 :class:`str` and the return type :class:`str`. Subtypes are accepted as
 arguments.

+New features have been added to the typing module in each major version of
+Python. The `typing_extensions `_
+package provides backports to all supported versions of Python 3 for almost
+all of these features.
+
 .. _relevant-peps:

 Relevant PEPs

--
nosy: +meersuri

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46494] Mention typing_extensions in the typing documentation

[Guido van Rossum]

Change by Guido van Rossum :


--
nosy:  -gvanrossum

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46494] Mention typing_extensions in the typing documentation

[Ken Jin]

Ken Jin  added the comment:

Yes please, this is a great idea.

--
keywords: +easy, newcomer friendly

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46494] Mention typing_extensions in the typing documentation

[Sebastian Rittau]

Sebastian Rittau  added the comment:

Sounds like a good idea. I would put it into the introduction. I hear it will 
easily be missed in other sections.

Wouldn't a link to PyPI make more sense than a GitHub link?

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46494] Mention typing_extensions in the typing documentation

[Alex Waygood]

Alex Waygood  added the comment:

Sounds like a great idea. I like the idea of putting it in the "Relevant PEPs" 
section, as that section already details how the typing module has evolved over 
the past few major versions of Python.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46494] Mention typing_extensions in the typing documentation

[Jelle Zijlstra]

New submission from Jelle Zijlstra :

I've often seen people say things like "I can't use TypeGuard yet, I'm stuck on 
3.9". That's not true, because the typing_extensions package backports all 
typing features to all supported Python versions.

To help make people aware of this option, we should mention typing_extensions 
in https://docs.python.org/3.10/library/typing.html.

Perhaps this can go in the "Relevant PEPs" section, or at the end of the intro 
section.

Suggested wording:

"New features have been added to the typing module in each major version of 
Python. The typing extensions (link to GitHub) package provides backports to 
all supported versions of Python 3 for almost all of these features."

--
assignee: docs@python
components: Documentation
messages: 411434
nosy: AlexWaygood, Jelle Zijlstra, docs@python, gvanrossum, kj, sobolevn, 
srittau
priority: normal
severity: normal
status: open
title: Mention typing_extensions in the typing documentation
versions: Python 3.10, Python 3.11, Python 3.9

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com