Figure out a deprecation policy
maybe a deprecation decorator from some library, also a clear explanation on when to deprecate and when not to
maybe a deprecation decorator from some library, also a clear explanation on when to deprecate and when not to