diff --git a/releasenotes/notes/add-custom-user-data-content-d188c7c197b50acb.yaml b/releasenotes/notes/add-custom-user-data-content-d188c7c197b50acb.yaml
index 748e81c1deaefa460ba947a7fbcb1ab6915f9f70..3dfc80b9d9a5ea86b63f006b7a96eb8d8844a299 100644
--- a/releasenotes/notes/add-custom-user-data-content-d188c7c197b50acb.yaml
+++ b/releasenotes/notes/add-custom-user-data-content-d188c7c197b50acb.yaml
@@ -2,5 +2,5 @@
 features:
   - |
     Adds a new ``kolla_bifrost_deploy_image_user_data_content`` variable used
-    to define the custom user_data content used by the cloud-init for overcloud
+    to define custom ``user_data`` content used by cloud-init for overcloud
     provision.
diff --git a/releasenotes/notes/adds-nvidia-vgpu-support-b4c6f08a06c373c6.yaml b/releasenotes/notes/adds-nvidia-vgpu-support-b4c6f08a06c373c6.yaml
index b67cccf1d76cf6dbeff44bfca885fd8d05fe0e51..589a51ce6d557da32c141122a2b6d552759275e5 100644
--- a/releasenotes/notes/adds-nvidia-vgpu-support-b4c6f08a06c373c6.yaml
+++ b/releasenotes/notes/adds-nvidia-vgpu-support-b4c6f08a06c373c6.yaml
@@ -1,7 +1,7 @@
 ---
 features:
   - |
-    Adds initial support for configuring NVIDIA vGPUs. For more information please see
-    the `new documentation
-    <https://docs.openstack.org/kayobe/latest/configuration/reference/vgpu.yml>`_
+    Adds initial support for configuring NVIDIA vGPUs. For more information
+    please see the `new documentation
+    <https://docs.openstack.org/kayobe/latest/configuration/reference/vgpu.html>`_
     for this feature.
diff --git a/releasenotes/notes/dellos10-support-ngs-24ba50803b4bf528.yaml b/releasenotes/notes/dellos10-support-ngs-24ba50803b4bf528.yaml
index a659fb3229e423742c7a56fc7d1ca357133ee5f4..a54cfa3d6f8c5a4c6b96a54641ce840377d119ea 100644
--- a/releasenotes/notes/dellos10-support-ngs-24ba50803b4bf528.yaml
+++ b/releasenotes/notes/dellos10-support-ngs-24ba50803b4bf528.yaml
@@ -1,4 +1,4 @@
 ---
 features:
   - |
-    Adds support for using DellOS 10 switches with Networking Generic Switch.
+    Adds support for using Dell OS10 switches with Networking Generic Switch.
diff --git a/releasenotes/notes/environment-dependencies-22df2a38a653425b.yaml b/releasenotes/notes/environment-dependencies-22df2a38a653425b.yaml
index cf71fcc47aa0487ceabd532b1ff59d6a8487f0b2..dc9d7d6f4b67f99249398c92d05009902a1dcfed 100644
--- a/releasenotes/notes/environment-dependencies-22df2a38a653425b.yaml
+++ b/releasenotes/notes/environment-dependencies-22df2a38a653425b.yaml
@@ -1,5 +1,5 @@
 ---
 features:
   - |
-    Adds a experimental support for layering multiple environments using a
-    .kayobe-environment file.
+    Adds experimental support for layering multiple environments using a
+    ``.kayobe-environment`` file.
diff --git a/releasenotes/notes/fallback-to-templating-when-only-one-source-exists-5eb19c0f6b8820d5.yaml b/releasenotes/notes/fallback-to-templating-when-only-one-source-exists-5eb19c0f6b8820d5.yaml
index 6edcb55cabd513238e54bf7ca41db27ec66f5bfa..ee18f43cc4038261dfb5518681f5f4dd491cc7c7 100644
--- a/releasenotes/notes/fallback-to-templating-when-only-one-source-exists-5eb19c0f6b8820d5.yaml
+++ b/releasenotes/notes/fallback-to-templating-when-only-one-source-exists-5eb19c0f6b8820d5.yaml
@@ -1,7 +1,7 @@
 ---
 fixes:
   - |
-    When merging kolla config, fallback to templating when only one source file
-    exists. This allows you to use config that templates to invalid yaml/ini as
-    long as there isn't an environment override. This improves backwards
-    compatability where it was permitted to use such constructs.
+    When merging Kolla configuration, fallback to templating when only one
+    source file exists. This allows you to use configuration that templates to
+    invalid YAML/INI as long as there is no environment override. This improves
+    backwards compatibility where it was permitted to use such constructs.
diff --git a/releasenotes/notes/feature-merge-kolla-configs-99773e2f0af2ea4b.yaml b/releasenotes/notes/feature-merge-kolla-configs-99773e2f0af2ea4b.yaml
index 74f5773f0c44274fced5361aaccf7a0ccfc712ac..e6e68302728e8cc48e051fe49a1ef90c299b0f04 100644
--- a/releasenotes/notes/feature-merge-kolla-configs-99773e2f0af2ea4b.yaml
+++ b/releasenotes/notes/feature-merge-kolla-configs-99773e2f0af2ea4b.yaml
@@ -46,7 +46,6 @@ deprecations:
     * ``kolla_extra_placement``
     * ``kolla_extra_sahara``
 
-    Use of Kolla custom service configuration files in
-    ``etc/kayobe/kolla/config`` and
+    Kolla custom service configuration files in ``etc/kayobe/kolla/config`` and
     ``etc/kayobe/environments/<environment>/kolla/config`` should be used
     instead.
diff --git a/releasenotes/notes/honor-ssh-args-for-bootstrap-ba894df14ba58167.yaml b/releasenotes/notes/honor-ssh-args-for-bootstrap-ba894df14ba58167.yaml
index 527d9a178a05fa8858fb1cba69a9d54a35541499..4344086425b031cc72aa06427696d1f1d9922609 100644
--- a/releasenotes/notes/honor-ssh-args-for-bootstrap-ba894df14ba58167.yaml
+++ b/releasenotes/notes/honor-ssh-args-for-bootstrap-ba894df14ba58167.yaml
@@ -2,12 +2,12 @@
 fixes:
   - |
     When determining whether or not a host needs bootstrapping, we attempt to
-    connect to the host using ansible_user, if the login fails, we then assume
-    that the host needs bootstrapping. In previous releases we used a manually
-    crafted ``ssh`` command. This did respect any customisations to the SSH
-    arguments made through ansible configuration.  We now use the raw module so
-    that these customisations are used when connecting to the host. One
-    possible use case is to configure a jump host between the control host and
-    the target hosts. If bootstrapping was needed, hosts will now show as
+    connect to the host using ``ansible_user``, if the login fails, we then
+    assume that the host needs bootstrapping. In previous releases we used a
+    manually crafted ``ssh`` command. This did not respect any customisations
+    to the SSH arguments made through Ansible configuration. We now use the raw
+    module so that these customisations are used when connecting to the host.
+    One possible use case is to configure a jump host between the control host
+    and the target hosts. If bootstrapping was needed, hosts will now show as
     unreachable in the summary stats at the end of the run. This can safely be
     ignored.
diff --git a/releasenotes/notes/kolla-passwords-overrides-065fd6bb8eb9689d.yaml b/releasenotes/notes/kolla-passwords-overrides-065fd6bb8eb9689d.yaml
index adc5318e7dc464cf668786d4dcad7c19361e16fd..e66f0579932d385752662102c49935e843649cea 100644
--- a/releasenotes/notes/kolla-passwords-overrides-065fd6bb8eb9689d.yaml
+++ b/releasenotes/notes/kolla-passwords-overrides-065fd6bb8eb9689d.yaml
@@ -6,9 +6,9 @@ fixes:
     ``kolla_ansible_default_custom_passwords`` and own dictionary with custom
     passwords in configuration files. Now
     ``kolla_ansible_extra_custom_passwords`` should provide only user custom
-    passwords to add or override in the passwords.yml.
+    passwords to add or override in ``kolla/passwords.yml``.
 upgrade:
   - |
-    Now no need to combine ``kolla_ansible_default_custom_passwords`` and
-    ``kolla_ansible_custom_passwords`` in your custom configuration. Just use
-    ``kolla_ansible_extra_custom_passwords`` to add or override passwords.
+    Introduces a new variable ``kolla_ansible_extra_custom_passwords`` to avoid
+    the need to combine ``kolla_ansible_default_custom_passwords`` and
+    ``kolla_ansible_custom_passwords`` when adding or overriding passwords.