René's URL Explorer Experiment


Title: typing: Improve documentation of generic classes and aliases by AlexWaygood · Pull Request #105369 · python/cpython · GitHub

Open Graph Title: typing: Improve documentation of generic classes and aliases by AlexWaygood · Pull Request #105369 · python/cpython

X Title: typing: Improve documentation of generic classes and aliases by AlexWaygood · Pull Request #105369 · python/cpython

Description: The documentation for typing.Dict currently describes the alias as: A generic version of :class:dict. In 2023, this is pretty misleading: it implies that dict is not generic, and that you have to use typing.Dict if you want to supply type parameters. There are similar issues across the typing documentation for the various aliases that were deprecated as part of PEP-585. This PR also makes a few related edits to the docs for generic classes, which look like they still have some pre-PEP-585 language in them. 📚 Documentation preview 📚: https://cpython-previews--105369.org.readthedocs.build/

Open Graph Description: The documentation for typing.Dict currently describes the alias as: A generic version of :class:dict. In 2023, this is pretty misleading: it implies that dict is not generic, and that you have to...

X Description: The documentation for typing.Dict currently describes the alias as: A generic version of :class:dict. In 2023, this is pretty misleading: it implies that dict is not generic, and that you have to...

Opengraph URL: https://github.com/python/cpython/pull/105369

X: @github

direct link

Domain: github.com

route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:0c3f020b-a42e-5ca5-f77c-c3ff70f5ca7b
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idDFB8:15F89A:11D0380:18A2A26:696A9BF6
html-safe-nonceb60b680efc5b3a0df21a352159ab76993486e21dd911f3da57cc7bbdf066cf42
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJERkI4OjE1Rjg5QToxMUQwMzgwOjE4QTJBMjY6Njk2QTlCRjYiLCJ2aXNpdG9yX2lkIjoiNTk3MDYwNTk0MDQ0NjczMDE0IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmac73d3aa99a7044fefafbfed851b111bb2208878df2ae56d3476b1a70f5b8b2a62
hovercard-subject-tagpull_request:1380770019
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/python/cpython/pull/105369/files
twitter:imagehttps://avatars.githubusercontent.com/u/66076021?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/66076021?s=400&v=4
og:image:altThe documentation for typing.Dict currently describes the alias as: A generic version of :class:dict. In 2023, this is pretty misleading: it implies that dict is not generic, and that you have to...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
Nonec0d8175e41e0e55b9e984c935b24b808cabab919dd3174aa45dac3ef503ed1af
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/python/cpython git https://github.com/python/cpython.git
octolytics-dimension-user_id1525981
octolytics-dimension-user_loginpython
octolytics-dimension-repository_id81598961
octolytics-dimension-repository_nwopython/cpython
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id81598961
octolytics-dimension-repository_network_root_nwopython/cpython
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release99aab454e5ddc8df30805fb76c114c3008a15842
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/python/cpython/pull/105369/files#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Fcpython%2Fpull%2F105369%2Ffiles
GitHub CopilotWrite better code with AIhttps://github.com/features/copilot
GitHub SparkBuild and deploy intelligent appshttps://github.com/features/spark
GitHub ModelsManage and compare promptshttps://github.com/features/models
MCP RegistryNewIntegrate external toolshttps://github.com/mcp
ActionsAutomate any workflowhttps://github.com/features/actions
CodespacesInstant dev environmentshttps://github.com/features/codespaces
IssuesPlan and track workhttps://github.com/features/issues
Code ReviewManage code changeshttps://github.com/features/code-review
GitHub Advanced SecurityFind and fix vulnerabilitieshttps://github.com/security/advanced-security
Code securitySecure your code as you buildhttps://github.com/security/advanced-security/code-security
Secret protectionStop leaks before they starthttps://github.com/security/advanced-security/secret-protection
Why GitHubhttps://github.com/why-github
Documentationhttps://docs.github.com
Bloghttps://github.blog
Changeloghttps://github.blog/changelog
Marketplacehttps://github.com/marketplace
View all featureshttps://github.com/features
Enterpriseshttps://github.com/enterprise
Small and medium teamshttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
App Modernizationhttps://github.com/solutions/use-case/app-modernization
DevSecOpshttps://github.com/solutions/use-case/devsecops
DevOpshttps://github.com/solutions/use-case/devops
CI/CDhttps://github.com/solutions/use-case/ci-cd
View all use caseshttps://github.com/solutions/use-case
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
View all industrieshttps://github.com/solutions/industry
View all solutionshttps://github.com/solutions
AIhttps://github.com/resources/articles?topic=ai
Software Developmenthttps://github.com/resources/articles?topic=software-development
DevOpshttps://github.com/resources/articles?topic=devops
Securityhttps://github.com/resources/articles?topic=security
View all topicshttps://github.com/resources/articles
Customer storieshttps://github.com/customer-stories
Events & webinarshttps://github.com/resources/events
Ebooks & reportshttps://github.com/resources/whitepapers
Business insightshttps://github.com/solutions/executive-insights
GitHub Skillshttps://skills.github.com
Documentationhttps://docs.github.com
Customer supporthttps://support.github.com
Community forumhttps://github.com/orgs/community/discussions
Trust centerhttps://github.com/trust-center
Partnershttps://github.com/partners
GitHub SponsorsFund open source developershttps://github.com/sponsors
Security Labhttps://securitylab.github.com
Maintainer Communityhttps://maintainers.github.com
Acceleratorhttps://github.com/accelerator
Archive Programhttps://archiveprogram.github.com
Topicshttps://github.com/topics
Trendinghttps://github.com/trending
Collectionshttps://github.com/collections
Enterprise platformAI-powered developer platformhttps://github.com/enterprise
GitHub Advanced SecurityEnterprise-grade security featureshttps://github.com/security/advanced-security
Copilot for BusinessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/premium-support
Pricinghttps://github.com/pricing
Search syntax tipshttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
documentationhttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Fcpython%2Fpull%2F105369%2Ffiles
Sign up https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=python%2Fcpython
Reloadhttps://github.com/python/cpython/pull/105369/files
Reloadhttps://github.com/python/cpython/pull/105369/files
Reloadhttps://github.com/python/cpython/pull/105369/files
python https://github.com/python
cpythonhttps://github.com/python/cpython
Please reload this pagehttps://github.com/python/cpython/pull/105369/files
Notifications https://github.com/login?return_to=%2Fpython%2Fcpython
Fork 33.9k https://github.com/login?return_to=%2Fpython%2Fcpython
Star 71.1k https://github.com/login?return_to=%2Fpython%2Fcpython
Code https://github.com/python/cpython
Issues 5k+ https://github.com/python/cpython/issues
Pull requests 2.1k https://github.com/python/cpython/pulls
Actions https://github.com/python/cpython/actions
Projects 31 https://github.com/python/cpython/projects
Security Uh oh! There was an error while loading. Please reload this page. https://github.com/python/cpython/security
Please reload this pagehttps://github.com/python/cpython/pull/105369/files
Insights https://github.com/python/cpython/pulse
Code https://github.com/python/cpython
Issues https://github.com/python/cpython/issues
Pull requests https://github.com/python/cpython/pulls
Actions https://github.com/python/cpython/actions
Projects https://github.com/python/cpython/projects
Security https://github.com/python/cpython/security
Insights https://github.com/python/cpython/pulse
Sign up for GitHub https://github.com/signup?return_to=%2Fpython%2Fcpython%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fpython%2Fcpython%2Fissues%2Fnew%2Fchoose
AlexWaygoodhttps://github.com/AlexWaygood
python:mainhttps://github.com/python/cpython/tree/main
AlexWaygood:deprecated-aliaseshttps://github.com/AlexWaygood/cpython/tree/deprecated-aliases
Conversation 14 https://github.com/python/cpython/pull/105369
Commits 6 https://github.com/python/cpython/pull/105369/commits
Checks 0 https://github.com/python/cpython/pull/105369/checks
Files changed https://github.com/python/cpython/pull/105369/files
Please reload this pagehttps://github.com/python/cpython/pull/105369/files
typing: Improve documentation of generic classes and aliases https://github.com/python/cpython/pull/105369/files#top
Show all changes 6 commits https://github.com/python/cpython/pull/105369/files
b66ca2e typing: Improve documentation of generic classes AlexWaygood Jun 6, 2023 https://github.com/python/cpython/pull/105369/commits/b66ca2e329eed610f086f4015bcb1c721c192968
86ca042 Fix typo AlexWaygood Jun 6, 2023 https://github.com/python/cpython/pull/105369/commits/86ca042e0807ff7ec418b4e17c49ee450638a6a8
25011b3 Partially address review AlexWaygood Jun 7, 2023 https://github.com/python/cpython/pull/105369/commits/25011b3e9e9269cff66f2a47564f2e9fa0c65497
d10f03c Merge branch 'main' into deprecated-aliases AlexWaygood Jun 7, 2023 https://github.com/python/cpython/pull/105369/commits/d10f03cb1ba3b433d834938199c127f1004b23e0
f56a9dd Sync docstring with change to mention Concatenate AlexWaygood Jun 7, 2023 https://github.com/python/cpython/pull/105369/commits/f56a9ddb321be59e6a8c2f660ed3345df46d8ea1
1122321 Finish addressing review AlexWaygood Jun 7, 2023 https://github.com/python/cpython/pull/105369/commits/1122321451d9e631808366dbf662cb07730c65aa
Clear filters https://github.com/python/cpython/pull/105369/files
Please reload this pagehttps://github.com/python/cpython/pull/105369/files
Please reload this pagehttps://github.com/python/cpython/pull/105369/files
typing.rst https://github.com/python/cpython/pull/105369/files#diff-8a0f115fde6769c122b771b6d0eca184c4580f7b5fabe2f0b0579c679424364f
typing.py https://github.com/python/cpython/pull/105369/files#diff-ddb987fca5f5df0c9a2f5521ed687919d70bb3d64eaeb8021f98833a2a716887
Please reload this pagehttps://github.com/python/cpython/pull/105369/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.