so migration path would be
1. @Deprecated(“…”, hidden = false) // source code still compiles, but gives warnings. User fixes the code.
2. @Deprecated(“…”, hidden = true) // source code gives errors, but old compiled code still works.
3. Remove declaration (or not)