CLI Deprecation Policy

The Salesforce CLI deprecation policy is:

• Salesforce can deprecate a command or parameter in any major update of the salesforcedx plug-in.
• Salesforce removes the deprecated command or parameter in the next major release of the salesforcedx plug-in. For example, if Salesforce deprecates a command in version 41, it does not appear in version 42.
• If you use a command or parameter that’s been deprecated but not yet removed, you get a warning message in stderr when you specify human-readable output. If you specify JSON output, the warning is presented as a property. The message includes the plug-in version of when the command or parameter will be removed. The command help also includes deprecation information when appropriate.
• When possible, Salesforce provides a functional alternative to the deprecated command or parameter.
• Salesforce announces new and upcoming deprecated commands and parameters in the release notes.