summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZuul <zuul@review.openstack.org>2019-03-15 17:47:36 +0000
committerGerrit Code Review <review@openstack.org>2019-03-15 17:47:36 +0000
commitd1797d8f58ff657fd3045d2f6b6e6e6d067c0ed6 (patch)
tree302256515f8a0b2c439f4a332fa1a66d40e52c89
parentd40125ef7f16978e398db044fcb52b380e751af2 (diff)
parent5de08c096675378d865fdaabb970191c5db0456f (diff)
Merge "docs: cleanup driver parity scope section"
-rw-r--r--doc/source/contributor/project-scope.rst12
1 files changed, 7 insertions, 5 deletions
diff --git a/doc/source/contributor/project-scope.rst b/doc/source/contributor/project-scope.rst
index 4a688fa..85b032d 100644
--- a/doc/source/contributor/project-scope.rst
+++ b/doc/source/contributor/project-scope.rst
@@ -89,15 +89,15 @@ it is expected that gap with shrink over time.
89Driver Parity 89Driver Parity
90************** 90**************
91 91
92Our goal for the Nova API to provide a consistent abstraction to access 92Our goal for the Nova API is to provide a consistent abstraction to access
93on demand compute resources. We are not aiming to expose all features of all 93on demand compute resources. We are not aiming to expose all features of all
94hypervisors. Where the details of the underlying hypervisor leak through 94hypervisors. Where the details of the underlying hypervisor leak through
95our APIs, we have failed in this goal, and we must work towards better 95our APIs, we have failed in this goal, and we must work towards better
96abstractions that are more interoperable. 96abstractions that are more `interoperable`_.
97This is one reason why we put so much emphasis on the use of Tempest in third 97This is one reason why we put so much emphasis on the use of Tempest in third
98party CI systems. 98party CI systems.
99 99
100The key tenant of driver parity is that if a feature is supported in a driver, 100The key tenet of driver parity is that if a feature is supported in a driver,
101it must feel the same to users, as if they where using any of the other 101it must feel the same to users, as if they where using any of the other
102drivers that also support that feature. The exception is that, if possible for 102drivers that also support that feature. The exception is that, if possible for
103widely different performance characteristics, but the effect of that API call 103widely different performance characteristics, but the effect of that API call
@@ -107,11 +107,13 @@ Following on from that, should a feature only be added to one of the drivers,
107we must make every effort to ensure another driver could be implemented to 107we must make every effort to ensure another driver could be implemented to
108match that behavior. 108match that behavior.
109 109
110Its important that drivers support enough features, so the API actually 110It is important that drivers support enough features, so the API actually
111provides a consistent abstraction. For example, being unable to create a 111provides a consistent abstraction. For example, being unable to create a
112server or delete a server, would severely undermine that goal. 112server or delete a server would severely undermine that goal.
113In fact, Nova only ever manages resources it creates. 113In fact, Nova only ever manages resources it creates.
114 114
115.. _interoperable: https://www.openstack.org/brand/interop/
116
115Upgrades 117Upgrades
116--------- 118---------
117 119