Deprecation

Deprecation marks an interface as discouraged while giving consumers time to migrate to a supported replacement. It should identify the replacement and explain the meaningful behavioral differences. WordPress provides mechanisms for signaling deprecated functions and arguments. Removing a deprecated interface is a later compatibility decision, so users need clear version expectations instead of an unexplained disappearance.