@civodul
There is a well-known deprecation policy for Python.
https://peps.python.org/pep-0387/
I like the deprecation documentation in Perl, which is very precise. Specifically, some features are introduced as experimental and possibly deprecated if they hurt more than they are perceived as an advantage.
https://perldoc.perl.org/perldeprecation
In the case of very large projects, like a distribution, I don't think a deprecation policy is really practical: there are too many variables due to subprojects....