Title: Future of typing_extensions.Doc · Issue #443 · python/typing_extensions · GitHub
Open Graph Title: Future of typing_extensions.Doc · Issue #443 · python/typing_extensions
X Title: Future of typing_extensions.Doc · Issue #443 · python/typing_extensions
Description: PEP-727 proposed a new Doc construct, but the PEP is unlikely to be accepted and will probably be withdrawn (https://discuss.python.org/t/pep-727-documentation-metadata-in-typing/32566/181). That makes it so we have to figure out what to...
Open Graph Description: PEP-727 proposed a new Doc construct, but the PEP is unlikely to be accepted and will probably be withdrawn (https://discuss.python.org/t/pep-727-documentation-metadata-in-typing/32566/181). That m...
X Description: PEP-727 proposed a new Doc construct, but the PEP is unlikely to be accepted and will probably be withdrawn (https://discuss.python.org/t/pep-727-documentation-metadata-in-typing/32566/181). That m...
Opengraph URL: https://github.com/python/typing_extensions/issues/443
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Future of typing_extensions.Doc","articleBody":"PEP-727 proposed a new `Doc` construct, but the PEP is unlikely to be accepted and will probably be withdrawn (https://discuss.python.org/t/pep-727-documentation-metadata-in-typing/32566/181).\r\n\r\nThat makes it so we have to figure out what to do with `typing_extensions.Doc` in the future. We don't have any previous cases where a feature was proposed in a PEP that didn't get accepted. We do have the precedent of `typing_extensions.IntVar`, which was added a long time ago without ever being proposed in a PEP. It is still in `typing_extensions` but undocumented.\r\n\r\nI'm hesitant to remove importable objects from typing_extensions, because this library is so widely used and is a dependency of many other important libraries. If we remove something, we could end up breaking an important third-party library. Libraries could also end up pinning the version of typing-extensions they depend on, which is disruptive because it restricts users using that library from using new features of newer versions of typing-extensions.\r\n\r\n`Doc` is also quite simple (a single class of a few dozen lines; no interaction with other features). Therefore, I don't see a big problem with keeping it around. However, we should mark it as deprecated in the documentation and probably move it into its own section.","author":{"url":"https://github.com/JelleZijlstra","@type":"Person","name":"JelleZijlstra"},"datePublished":"2024-08-12T21:05:30Z","url":"https://github.com/python/typing_extensions/issues/443"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:11553f08-dcb9-b298-acfd-68c2f0ddaf43 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | E08C:30DBED:3566729:468FE9A:6B003AA3 |
| html-safe-nonce | 792b039c33fc4cc52b7652ea0aa198e3e3e120dc28aaa50d32289c06956cc6dd |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFMDhDOjMwREJFRDozNTY2NzI5OjQ2OEZFOUE6NkIwMDNBQTMiLCJ2aXNpdG9yX2lkIjoiNDA2NjA4NjE1NDEyOTEyODA5OSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | a3c509e7c8942eddb3f569ba5d974425e173d11d915c2077b557c842f5a0fb9a |
| hovercard-subject-tag | issue:2461895173 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/typing_extensions/443/issue_layout |
| twitter:image | https://opengraph.githubassets.com/411dba97ca9292ef27084897d213e006ab81019b031200b99768b89191a7b44c/python/typing_extensions/issues/443 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/411dba97ca9292ef27084897d213e006ab81019b031200b99768b89191a7b44c/python/typing_extensions/issues/443 |
| og:image:alt | PEP-727 proposed a new Doc construct, but the PEP is unlikely to be accepted and will probably be withdrawn (https://discuss.python.org/t/pep-727-documentation-metadata-in-typing/32566/181). That m... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | JelleZijlstra |
| hostname | github.com |
| expected-hostname | github.com |
| None | 7d0829bbde9e48b2486cb5dd6d147896eb01d32134627091f818958a935ef3f0 |
| turbo-cache-control | no-preview |
| go-import | github.com/python/typing_extensions git https://github.com/python/typing_extensions.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 494077289 |
| octolytics-dimension-repository_nwo | python/typing_extensions |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 494077289 |
| octolytics-dimension-repository_network_root_nwo | python/typing_extensions |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | f3f3a43ca095cdea3abbb394112e971f9fdb94fa |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width