diff --git a/releasenotes/notes/python-cli-3e568065b8706e73.yaml b/releasenotes/notes/python-cli-3e568065b8706e73.yaml
index b9c13f8ad6b139fc0c029e0602efab5e079ab026..de51a807d4547ca824307209e49780b14854dcce 100644
--- a/releasenotes/notes/python-cli-3e568065b8706e73.yaml
+++ b/releasenotes/notes/python-cli-3e568065b8706e73.yaml
@@ -1,16 +1,16 @@
 ---
 upgrade:
   - |
-    Rewrite kolla-ansible CLI to python
+    Rewrite kolla-ansible CLI in Python. Moving the CLI to Python allows for
+    easier maintenance and larger feature set. The CLI was built using the
+    cliff package that is used in the ``openstack`` and ``kayobe`` commands.
 
-    Moving the CLI to python allows for easier
-    maintenance and larger feature set.
-    The CLI was built using the cliff package
-    that is used in openstack-cli and kayobe-cli.
+    This patch introduces a few breaking changes stemming from the nature of
+    the cliff package:
 
-    This patch introduces a few breaking changes.
-    The changes stem the nature of the cliff package.
-    1. the order of parameters must be
-    kolla-ansible <action> <arguments>
-    2. mariadb_backup and mariadb_recovery now are
-    mariadb-backup and mariadb-recovery
+    * the order of parameters must be ``kolla-ansible <action> <arguments>``
+    * ``mariadb_backup`` and ``mariadb_recovery`` now are ``mariadb-backup``
+      and ``mariadb-recovery``
+
+    The ``--key`` parameter has also been dropped as it was duplicating
+    ``--vault-password-file``.