Аннотация Deprecated в Kotlin позволяет не только пометить код, но и так же сразу добавить информацию на что его заменить (ReplaceWith), а также указать насколько важно заменить это deprecated API (DeprecationLevel).
Это эффективно работает в связке с IDEA и улучшается жизнь пользователей вашего API и коллег