Improve `TypedDict` documentation by AlexWaygood · Pull Request #770 · python/typing_extensions · GitHub
Skip to content

Improve TypedDict documentation#770

Merged
AlexWaygood merged 2 commits into
mainfrom
typeddicts
Jun 25, 2026
Merged

Improve TypedDict documentation#770
AlexWaygood merged 2 commits into
mainfrom
typeddicts

Conversation

@AlexWaygood

@AlexWaygood AlexWaygood commented Jun 25, 2026

Copy link
Copy Markdown
Member
  • Our source code had several confusing comments referring to PEP 728 not yet having been implemented upstream. It's been implemented upstream for a while now, but we can't yet simply re-export TypedDict on Python 3.15 because...
  • ...We never documented that typing_extensions includes experimental support for PEP 764 (inline TypedDicts).

This PR improves the documentation for TypedDicts. To test the PR, I built the docs locally, which exposed:

  • I didn't know how to do that for this repo. This PR adds some notes to CONTRIBUTING.md on how to do that.
  • The docs build already failed on main with nitpicky mode, because the signature we gave for dataclass_transform in the docs was invalid (you can't do multiline definitions like that with Sphinx). This PR therefore also fixes those issues, and adds a CI job to build the docs with nitpicky mode, to prevent issues like that from reoccurring.

@codecov

codecov Bot commented Jun 25, 2026

Copy link
Copy Markdown

@AlexWaygood AlexWaygood added the documentation Improvements or additions to documentation label Jun 25, 2026
@AlexWaygood AlexWaygood marked this pull request as ready for review June 25, 2026 11:28
@AlexWaygood AlexWaygood merged commit 8dcc559 into main Jun 25, 2026
25 checks passed
@AlexWaygood AlexWaygood deleted the typeddicts branch June 25, 2026 14:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants