Boas práticas para deprecar funcionalidades sem quebrar nada

Deprecação e remoção imediata são conceitos distintos, mas frequentemente confundidos. Enquanto a remoção imediata elimina uma funcionalidade de uma só vez, a deprecação é um processo gradual que avisa os usuários sobre a obsolescência futura. O ciclo de vida ideal de uma funcionalidade segue três fases: estável (totalmente suportada), obsoleta (ainda funcional, mas com avisos de descontinuação) e removida (eliminada do código). A comunicação clara com o time e os usuários é o alicerce desse pro