Skip to content

Rework the "Supported Type System Features" section - #16490

Merged
srittau merged 4 commits into
python:mainfrom
srittau:contributing-supported
Oct 7, 2026
Merged

srittau merged 4 commits into
python:mainfrom
srittau:contributing-supported

Conversation

@srittau

@srittau srittau commented Oct 6, 2026

Copy link
Copy Markdown
Collaborator
  • Rename to "Unsupported ...".
  • Remove list of supported features.
  • Instead add a note that everything is supported, unless noted otherwise.
  • Add generics syntax and type statements as unsupported.
  • Add TypeForm to typing_extensions import list.
  • Move the section about bytes promotions to a separate section.

Rationale: As more and more typing features are added, this list keeps growing and by now is mostly a list of nearly all type system features. On the other hand, we listed nowhere what you can't use in typeshed. So this PR switched the logic around. Also moved the section about bytes promotions, which doesn't fit exactly here. (Also as this is now the standard, we can probably remove it at some point, although the note about _typeshed aliases is still valid. But that's a different concern.)

Sidenote: The CONTRIBUTING file has accumulated a lot of cruft over the last few years, and the structure isn't great. This needs a serious overhaul at some point.

@JelleZijlstra I think you originally added this section and were maintaining it, so I'd like to get your input on this.

- Rename to "Unsupported ...".
- Remove list of supported features.
- Instead add a note that everything is supported, unless noted otherwise.
- Add generics syntax and type statements as unsupported.
- List `TypeForm` in `typing_extensions` import list.
- Move the section about `bytes` promotions to a separate section.
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
@srittau
srittau merged commit ac31da9 into python:main Oct 7, 2026
1 check passed
@srittau
srittau deleted the contributing-supported branch October 7, 2026 15:31
@srittau srittau added the project: infrastructure typeshed build, test, documentation, or distribution related label Oct 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

project: infrastructure typeshed build, test, documentation, or distribution related

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants