[openstack-dev] [client][all][neutron] client option removal policy
Neil.Jerram at metaswitch.com
Mon Dec 7 12:24:02 UTC 2015
On 07/12/15 12:01, Akihiro Motoki wrote:
> neutronclient is now dropping XML support and as a result
> "--request-format" option is no longer needed as JSON is the only format now.
> What is the recommended way for options no longer needed?
> Does bumping major version of CLI allow us to drop an option without
> - Deprecate such option.
> The option still exists with only one available choiceuntil the
> option is deleted.
> - Drop it without deprecation.
> This breaks users who uses "--requiest-format json", but 'json' is the default
> value and most users do not specify the option.
I'd say it depends on how the deprecation of '--request-format xml' was
announced. If it said
"XML format is deprecated and will be removed in a future release. The
only supported format will then be JSON, and so the --request-format
option will also be removed"
then the option can clearly be removed now.
How was it announced? If I look at
I see many occurrences of
The XML or JSON request format.
without anything to say that XML is deprecated. And I see many other
things in the same page that _are_ marked as "DEPRECATED!" So, if I was
reading this documentation, I would not know that XML format is deprecated.
More information about the OpenStack-dev