diff --git a/releasenotes/notes/add-cors-to-versions-pipeline-56277ca66e796569.yaml b/releasenotes/notes/add-cors-to-versions-pipeline-56277ca66e796569.yaml
index 928c4a0ffcc1..3b520029e9ee 100644
--- a/releasenotes/notes/add-cors-to-versions-pipeline-56277ca66e796569.yaml
+++ b/releasenotes/notes/add-cors-to-versions-pipeline-56277ca66e796569.yaml
@@ -1,6 +1,7 @@
 ---
 upgrade:
-  - CORS headers have been added to the versions REST API, in order
-    to support versions discovery. If using 'oscomputeversions'
-    pipeline in '/etc/nova/api-paste.ini', it is required to update the
-    pipeline to include 'cors' filter.
+  - To allow access to the versions REST API from diverse origins,
+    CORS support has been added to the 'oscomputeversions' pipeline
+    in '/etc/nova/api-paste.ini'. Existing deployments that wish to
+    enable support should add the 'cors' filter at the start of the
+    'oscomputeversions' pipeline.