I just posted PEP 702, Marking deprecations using the type system: https://peps.python.org/pep-0702/.

The PEP proposes adding an @typing.deprecated() decorator to mark classes, methods, and functions as deprecated. Type checkers will leverage this decorator to inform users about their usage of deprecated features.

I welcome feedback on any aspect of the proposal. However, two main points came up in initial discussions:

- The proposal specifies that the decorator does not raise any runtime DeprecationWarning. Should we change this, perhaps with an opt-in flag?
- The proposal allows users to mark classes, functions, and overloads as deprecated, but there are other things that may want deprecation. Should we add support for deprecating modules, or variables, or parameters?

Happy New Year!