Clarify some release notes prior to the 7.0.0 release7.0.0

Change-Id: I55dc81659973ab5afc60b030b44f30e62b73dbd9

5 files changed, 21 insertions, 18 deletions

diff --git a/releasenotes/notes/clarify-project-id-variable-5832698315000438.yaml b/releasenotes/notes/clarify-project-id-variable-5832698315000438.yaml
index 16b5b5de..83182d1c 100644
--- a/releasenotes/notes/clarify-project-id-variable-5832698315000438.yaml
+++ b/releasenotes/notes/clarify-project-id-variable-5832698315000438.yaml
@@ -1,13 +1,13 @@
 ---
 deprecations:
-  - keyword argument **tenant_id** of novaclient.client.Client entry-point was
-    deprecated in favor of **project_id**;
-  - keyword argument **tenant_name** of novaclient.client.Client entry-point
-    was deprecated in favor of **project_name**;
+  - Keyword argument **tenant_id** of novaclient.client.Client entry-point was
+    deprecated in favor of **project_id**.
+  - Keyword argument **tenant_name** of novaclient.client.Client entry-point
+    was deprecated in favor of **project_name**.
 other:
   - The meaning of 'project_id' variable of novaclient.client.Client
     entry-point was not clear. In different cases it was used as ID or Name of
-    project(in terms of Keystone). The time to identify meaning is come, so now
-    project_id/tenant_id variables specifically mean about Project ID(in terms
-    of Keystone) and project_name/tenant_name variables take care about Project
-    Name(in terms of Keystone).
+    project (in terms of Keystone). The time to identify meaning is come, so
+    now project_id/tenant_id variables specifically mean Project ID (in terms
+    of Keystone) and project_name/tenant_name variables mean Project Name (in
+    terms of Keystone).
diff --git a/releasenotes/notes/deprecate-proxy-args-a3f4e224f7664ff8.yaml b/releasenotes/notes/deprecate-proxy-args-a3f4e224f7664ff8.yaml
index 887692a6..c513b6ff 100644
--- a/releasenotes/notes/deprecate-proxy-args-a3f4e224f7664ff8.yaml
+++ b/releasenotes/notes/deprecate-proxy-args-a3f4e224f7664ff8.yaml
@@ -1,5 +1,5 @@
 ---
 deprecations:
-  - There are two arguments for proxying stuff (proxy_tenant_id and
-    proxy_token) in novaclient.client.Client entry-point. They were never
-    documented and tested.
+  - The **proxy_tenant_id** and **proxy_token** arguments to the
+    novaclient.client.Client entry-point were never documented nor tested and
+    are now deprecated for removal in a future release.
diff --git a/releasenotes/notes/microversion-v2_38-0618fe2b3c7f96f9.yaml b/releasenotes/notes/microversion-v2_38-0618fe2b3c7f96f9.yaml
index 3f8bc84c..a9944a72 100644
--- a/releasenotes/notes/microversion-v2_38-0618fe2b3c7f96f9.yaml
+++ b/releasenotes/notes/microversion-v2_38-0618fe2b3c7f96f9.yaml
@@ -1,5 +1,5 @@
 ---
 upgrade:
   - Support for microversion 2.38 added. As of microversion 2.38, invalid
-    statuses passed to 'nova list --status invalid_status' will result in a
+    statuses passed to ``nova list --status invalid_status`` will result in a
     HTTP 400 Bad Request error response.
\ No newline at end of file
diff --git a/releasenotes/notes/rename-bypass-url-42cd96956a6bc6dc.yaml b/releasenotes/notes/rename-bypass-url-42cd96956a6bc6dc.yaml
index 9dc78f8b..dc6374e1 100644
--- a/releasenotes/notes/rename-bypass-url-42cd96956a6bc6dc.yaml
+++ b/releasenotes/notes/rename-bypass-url-42cd96956a6bc6dc.yaml
@@ -3,8 +3,8 @@ deprecations:
   - The **--bypass-url** CLI argument was deprecated in favor of
     **--endpoint-override**
   - The **bypass_url** argument of novaclient.client.Client entry-point was
-    deprecated in favor of **endpoint_override**
+    deprecated in favor of **endpoint_override**.
 fixes:
-  - Inability to use bypass-url with keystone session
+  - Inability to use bypass-url with keystone session is fixed.
 features:
-  - You can use *bypass-url*/**endpoint-override** with Keystone V3
+  - You can use **bypass-url** / **endpoint-override** with Keystone V3.
diff --git a/releasenotes/notes/restrict-args-for-novaclient-ep-491098c3634365be.yaml b/releasenotes/notes/restrict-args-for-novaclient-ep-491098c3634365be.yaml
index 15a651f6..11dda395 100644
--- a/releasenotes/notes/restrict-args-for-novaclient-ep-491098c3634365be.yaml
+++ b/releasenotes/notes/restrict-args-for-novaclient-ep-491098c3634365be.yaml
@@ -1,5 +1,8 @@
 ---
 upgrade:
-  - novaclient.client.Client entry-point accepts only 5 positional arguments(
-    version, username, api_key, project_id, auth_url). Using positional
-    arguments for all other options become an error.
+  - |
+    novaclient.client.Client entry-point accepts only 5 positional arguments::
+
+      version, username, api_key, project_id, auth_url
+
+    Using positional arguments for all other options is now an error.