openstack
/
governance
Code Issues Proposed changes

Add Resolution of TC stance on the OpenStackClient 

Change-Id: Ia467ad9e8d96ebebb3dd43cc3f67db81d9beb956
This commit is contained in:
Kendall Nelson 2020-10-27 09:39:29 -07:00 committed by Dan Smith
parent 3f85bfb545
commit 2d7c440104
1 changed files with 35 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
resolutions/20201028-openstackclient-tc-policy.rst Normal file
View File

@ -0,0 +1,35 @@
====================================
2020-10-28 OpenStackClient TC Policy
====================================
OpenStackClient (aka OSC) is a command-line client for OpenStack that
brings the command set for OpenStack service APIs together in a single
shell with a uniform command structure[0].
For several releases now, there has been much debate about unifying on
a single client and the best way to approach reaching parity between
the OSC and project specific clients that exist.
Having to use more than one client in a basic workflow is a very
confusing and frustrating experience for OpenStack users. Using a
combination of clients makes OpenStack feel disjointed and overly
complex.
In order to better support the user experience and encourage adoption
by new users of the unified client, we will have a twofold policy.
Firstly, going forward, OpenStack services should focus on ensuring
that all user-oriented documents use OpenStackClient CLIs wherever
possible, close gaps in it where necessary to enable this, and call
out specific and intentional uses of the python clients as
transitional until support can be added.
Secondly, in an effort to consume our preferred tooling, any scripts
or tests (outside of tempest) that interact with an OpenStack service
in our CI environment should use the OpenStackClient or OpenStackSDK
wherever possible. When this is not possible, a bug should be filed
highlighting the feature gap.
This resolution is not going to dictate a completion date, but is to
ensure that we make continuous forward progress in that direction.
[0] https://docs.openstack.org/python-openstackclient/latest/