typeshed icon indicating copy to clipboard operation
typeshed copied to clipboard

Third-party removal policy if upstream types are unsufficient

Open srittau opened this issue 1 year ago • 1 comments

Currently our policy says:

Third-party stubs are generally removed from typeshed when one of the following criteria is met:

  • The upstream package ships a py.typed file for at least six months, or [...]

We've had a few cases recently, where upstream added a py.typed file, but the annotations were clearly sub-par compared to the stubs from typeshed. In an ideal world, we'd contribute back our annotations, but that usually requires quite a bit of effort – even compared with continuing to support the stubs in typeshed. (Even if improving upstream's annotations and removal from typeshed should of course be the ultimate goal.)

I suggest to amend our policy to say:

  • The upstream package ships a py.typed file for at least six months, and the upstream type annotations are of a comparable standard to those in typeshed, [...]

The wording still leaves some wiggle room, and isn't overly specific, but is more specific than "usually" for this case.

srittau avatar May 18 '24 10:05 srittau

And we should probably not mark those stubs as "obsolete_since".

srittau avatar May 18 '24 10:05 srittau