Deprecated (в переводе с англ. осужденный) — означает, что функционал устарел (метод, функция) и его лучше не использовать.

Разрабочики помечают устаревший метод deprecated. При этом, как правило, добавляется альтернативный новый метод, который рекомендуется к использованию вместо старого. Это нужно для обратной совместимости. Т.е. чтобы с выходом новых версий старый код продолжал работать, как и раньше. Затем, через определенное время или определённое количество версий от deprecated отказываются совсем.

Если появилась новая улучшенная реализация каких то возможностей, то вводится новый функционал, а старый функционал помечается deprecated.