[openstack-dev] [ironic][openstackclient] deprecation process
s.martinelli at gmail.com
Thu May 12 16:05:23 UTC 2016
I thought we had this written down somewhere but I can't find it. The OSC
deprecation process is two major releases. So if something was deprecated
in L, it is removed in N. This goes for optional parameters being renamed /
dropped, or commands being dropped / renamed.
If an optional parameter is being deprecated (say --tenant in favor of
--project), then we usually add a mutually exclusive group for these, and
force the user to only pick one, log a deprecation message if they pick the
wrong one, and suppress the help text of the old option. See  for an
If a command is being deprecated it's a bit easier, just log a deprecation
message and remove it. If it is being renamed then you can also have it
subclass the new command.
As always, the deprecation message should indicate which command / option
On Thu, May 12, 2016 at 9:46 AM, Loo, Ruby <ruby.loo at intel.com> wrote:
> Hi OpenStackClient folks,
> Ironic is following the standard deprecation process . We added an OSC
> plugin and realized that we didn’t get the commands quite right. This patch
>  adds the right commands and deprecates the wrong ones. My question is
> what the deprecation process might be. Since it is a plugin to OSC, should
> it follow OSC’s deprecation process and if so, what might that process be?
> Or since the commands are related to ironic, should it follow ironic’s
> deprecation process? In particular, I wanted to know how long should/must
> we support those deprecated commands.
> For the user’s sake, it seems like it would make sense that all OSC
> (plugin or not, does the user know the difference?) commands follow the
> same deprecation policy.
> I took a quick look and didn’t see anything documented about this, so I
> might have missed it.
> What sez you?
>  https://review.openstack.org/#/c/284160
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the OpenStack-dev