Skip to content

Commit 83e6df4

Browse files
authored
Add _typeshed cooldown period for 3rd-party stubs
Closes: #11903
1 parent a8887d5 commit 83e6df4

1 file changed

Lines changed: 9 additions & 0 deletions

File tree

stdlib/_typeshed/README.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,3 +32,12 @@ removed or changed in an incompatible way for at least one year.
3232
Before making such a change, the "stable" moniker will be removed
3333
and we will mark the type in question as deprecated. No guarantees
3434
are made about unmarked types.
35+
36+
## Use in 3rd-party Packages (`stubs`)
37+
38+
The `_typeshed` module is usually vendored by type checkers. To ensure that
39+
type checkers have a chance to pick up changes to this module, items added
40+
to `_typeshed` (or its submodules) have a two month cooldown period before
41+
they can be used in third-party stubs. For example, if `_typeshed.Fruzzle`
42+
is added on 2026-07-15, it can't be used before 2026-09-15. This restriction
43+
does not apply to standard library stubs.

0 commit comments

Comments
 (0)