From 328993d8b3525b08f5a628940254036be7ad07c8 Mon Sep 17 00:00:00 2001
From: Michal Nasiadka <mnasiadka@gmail.com>
Date: Thu, 27 Feb 2020 13:54:49 +0100
Subject: [PATCH] CI: Add doc8 linting of release notes

Change-Id: I1439aa923a9129b752abb4acfb88559930b2178a
---
 .../add-designate-producer-b6e94153ff9bc45c.yaml    |  3 ++-
 ...flag-for-provider-networks-3fb5de28ba89b128.yaml | 13 +++++++------
 .../notes/add-fluentd-role-bc3f4976c807a50b.yaml    |  5 +++--
 .../notes/add-freezer-74c9b538348cd62a.yaml         |  4 ++--
 ...rizon-custom-settings-file-d5dfab8a1a3b4ee7.yaml |  5 +++--
 .../notes/add-zun-role-275d41711e0fe206.yaml        |  6 +++---
 .../cloudKitty-v2-influxdb-07cb8b0051ac9ea0.yaml    |  3 ++-
 .../custom_option_docker-f5b810a8edce06fa.yaml      |  4 ++--
 ...eprecate-some-config-files-0ed8c75f6bb4aa26.yaml |  4 ++--
 .../enable-l3-port-forwarding-fe9af935437fc070.yaml |  3 ++-
 .../external-mariadb-support-131440d3c984dd67.yaml  | 12 ++++++++----
 .../notes/fix-ansible-warning-f9b382a13446f625.yaml |  6 +++---
 .../horizon_keystone_dropdown-6b9b4e5e9a64f979.yaml |  6 +++---
 .../notes/implement-ceph-nfs-ff8f9635c365923f.yaml  |  4 ++--
 releasenotes/notes/masakari-ddd930cf5db5f713.yaml   |  3 ++-
 ...role-with-neutron-l3-agent-90b91725344dda76.yaml | 13 +++++++------
 ...arameters-to-passwords-yml-b6a375e0eb8cf27f.yaml |  5 +++--
 ...endaylight_release-removal-5077cd473bee6dbd.yaml |  4 ++--
 ...ometheus-blackbox-exporter-ee096376656c3751.yaml |  4 ++--
 ...when-alertmanager-disabled-0090c1570ff4e632.yaml |  9 +++++----
 .../notes/remove-opendaylight-4caac9fbf25b8015.yaml |  4 ++--
 ...y-global-config-generation-8f42cea604ba1cf2.yaml |  5 +++--
 ...split_ovs_lb_agents_config-96f1f90e7d678209.yaml | 12 ++++++------
 ...rd-oslo-messaging-sections-4769da25bc58aa02.yaml | 11 ++++++-----
 .../support-ceph-dashboard-3ee5e489ea16ea25.yaml    |  4 ++--
 .../swift-multi-policies-28bc322b54a82bf9.yaml      |  6 +++---
 .../swift-replication-network-40ecd13e4339f299.yaml | 10 +++++-----
 .../notes/swift-s3api-2b51917b169fff78.yaml         |  3 ++-
 tox.ini                                             |  1 +
 29 files changed, 95 insertions(+), 77 deletions(-)

diff --git a/releasenotes/notes/add-designate-producer-b6e94153ff9bc45c.yaml b/releasenotes/notes/add-designate-producer-b6e94153ff9bc45c.yaml
index cd27145979..3e782055b4 100644
--- a/releasenotes/notes/add-designate-producer-b6e94153ff9bc45c.yaml
+++ b/releasenotes/notes/add-designate-producer-b6e94153ff9bc45c.yaml
@@ -1,3 +1,4 @@
 ---
 features:
-  - Add designate-producer ansible role. Orchestrates periodic tasks that are run by designate.
+  - Add designate-producer ansible role. Orchestrates periodic tasks that are
+    run by designate.
diff --git a/releasenotes/notes/add-flag-for-provider-networks-3fb5de28ba89b128.yaml b/releasenotes/notes/add-flag-for-provider-networks-3fb5de28ba89b128.yaml
index 61b4c44553..a37824b3ec 100644
--- a/releasenotes/notes/add-flag-for-provider-networks-3fb5de28ba89b128.yaml
+++ b/releasenotes/notes/add-flag-for-provider-networks-3fb5de28ba89b128.yaml
@@ -2,12 +2,13 @@
 features:
   - |
     Add a new flag to explicitly enable provider networks, i.e. networks where
-    instances directly connect to the physical networks (flat,VLAN). In such
+    instances directly connect to the physical networks (flat, VLAN). In such
     cases external bridges must be configured on compute nodes, like it is done
-    for self-service (tenant manageable) networks in DVR mode. Otherwise this flag
-    allows to avoid unnecessary interface and bridge setup on compute nodes
-    in case of tenant networks in non-DVR mode.
+    for self-service (tenant manageable) networks in DVR mode. Otherwise this
+    flag allows to avoid unnecessary interface and bridge setup on compute
+    nodes in case of tenant networks in non-DVR mode.
 upgrade:
   - |
-    By default this flag is disabled. If provider networks were used in previous
-    releases please set 'enable_neutron_provider_networks' property to 'yes'.
+    By default this flag is disabled. If provider networks were used in
+    previous releases, please set ``enable_neutron_provider_networks``
+    property to 'yes'.
diff --git a/releasenotes/notes/add-fluentd-role-bc3f4976c807a50b.yaml b/releasenotes/notes/add-fluentd-role-bc3f4976c807a50b.yaml
index 1cea8af500..09b011b4aa 100644
--- a/releasenotes/notes/add-fluentd-role-bc3f4976c807a50b.yaml
+++ b/releasenotes/notes/add-fluentd-role-bc3f4976c807a50b.yaml
@@ -1,5 +1,6 @@
 ---
 upgrade:
-  - Heka is deprecated and is replaced with Fluentd
+  - Heka is deprecated and is replaced with Fluentd.
 features:
-  - Add Fluentd role, Fluentd is an open source data collector for unified logging layer
+  - Add Fluentd role, Fluentd is an open source data collector for unified
+    logging layer
diff --git a/releasenotes/notes/add-freezer-74c9b538348cd62a.yaml b/releasenotes/notes/add-freezer-74c9b538348cd62a.yaml
index 065bdf9faf..4b2ddbe6da 100644
--- a/releasenotes/notes/add-freezer-74c9b538348cd62a.yaml
+++ b/releasenotes/notes/add-freezer-74c9b538348cd62a.yaml
@@ -1,4 +1,4 @@
 ---
 features:
-  - Freezer is a distributed backup restore and disaster recovery as a service platform
-    Add freezer ansible role
+  - Freezer is a distributed backup restore and disaster recovery as a service
+    platform. Add freezer ansible role.
diff --git a/releasenotes/notes/add-horizon-custom-settings-file-d5dfab8a1a3b4ee7.yaml b/releasenotes/notes/add-horizon-custom-settings-file-d5dfab8a1a3b4ee7.yaml
index ba08dd4dfd..b0b7a7cb6d 100644
--- a/releasenotes/notes/add-horizon-custom-settings-file-d5dfab8a1a3b4ee7.yaml
+++ b/releasenotes/notes/add-horizon-custom-settings-file-d5dfab8a1a3b4ee7.yaml
@@ -1,5 +1,6 @@
 ---
 features:
   - |
-    The settings file ``{{ node_custom_config}}/horizon/custom_local_settings`` can be
-    used in Horizon to overwrite the default local_settings without a need to sync it at image build time.
+    The settings file ``{{ node_custom_config}}/horizon/custom_local_settings``
+    can be used in Horizon to overwrite the default local_settings without
+    a need to sync it at image build time.
diff --git a/releasenotes/notes/add-zun-role-275d41711e0fe206.yaml b/releasenotes/notes/add-zun-role-275d41711e0fe206.yaml
index 6ecfaabaa0..49445aef13 100644
--- a/releasenotes/notes/add-zun-role-275d41711e0fe206.yaml
+++ b/releasenotes/notes/add-zun-role-275d41711e0fe206.yaml
@@ -1,5 +1,5 @@
 ---
 features:
-  - Add zun ansible role,Zun is an OpenStack project for the management of containers.
-    zun quick start guide link is
-    https://github.com/openstack/zun/blob/master/doc/source/dev/quickstart.rst
+  - Add zun ansible role. Zun is an OpenStack project for the management of
+    containers. Please see `Zun quick start guide
+    <https://github.com/openstack/zun/blob/master/doc/source/dev/quickstart.rst>`__.
diff --git a/releasenotes/notes/cloudKitty-v2-influxdb-07cb8b0051ac9ea0.yaml b/releasenotes/notes/cloudKitty-v2-influxdb-07cb8b0051ac9ea0.yaml
index 92f694f703..ebfc35f3c7 100644
--- a/releasenotes/notes/cloudKitty-v2-influxdb-07cb8b0051ac9ea0.yaml
+++ b/releasenotes/notes/cloudKitty-v2-influxdb-07cb8b0051ac9ea0.yaml
@@ -1,4 +1,5 @@
 ---
 features:
   - |
-    Add support to Kolla-Ansible for Cloudkitty InfluxDB storage system deployment.
+    Add support to Kolla-Ansible for Cloudkitty InfluxDB storage system
+    deployment.
diff --git a/releasenotes/notes/custom_option_docker-f5b810a8edce06fa.yaml b/releasenotes/notes/custom_option_docker-f5b810a8edce06fa.yaml
index 62d4a1d6d6..7f7b0cf8bb 100644
--- a/releasenotes/notes/custom_option_docker-f5b810a8edce06fa.yaml
+++ b/releasenotes/notes/custom_option_docker-f5b810a8edce06fa.yaml
@@ -1,5 +1,5 @@
 ---
 features:
   - |
-    Add custom option for docker daemon by configure the docker service. An operator
-    named "docker_custom_option" will be added.
+    Add custom option for docker daemon to configure the docker service. A
+    parameter named ``docker_custom_option`` is added.
diff --git a/releasenotes/notes/deprecate-some-config-files-0ed8c75f6bb4aa26.yaml b/releasenotes/notes/deprecate-some-config-files-0ed8c75f6bb4aa26.yaml
index 94953abab7..cc4e624ae4 100644
--- a/releasenotes/notes/deprecate-some-config-files-0ed8c75f6bb4aa26.yaml
+++ b/releasenotes/notes/deprecate-some-config-files-0ed8c75f6bb4aa26.yaml
@@ -1,8 +1,8 @@
 ---
 deprecations:
   - |
-    The following files are deprecated and should be removed during Queens cycle,
-    use /etc/kolla/config/global.conf instead:
+    The following files are deprecated and should be removed during Queens
+    cycle, use ``/etc/kolla/config/global.conf`` instead:
 
     * /etc/kolla/config/database.conf
     * /etc/kolla/config/messaging.conf
diff --git a/releasenotes/notes/enable-l3-port-forwarding-fe9af935437fc070.yaml b/releasenotes/notes/enable-l3-port-forwarding-fe9af935437fc070.yaml
index 9e28ee2727..a76d9ccad2 100644
--- a/releasenotes/notes/enable-l3-port-forwarding-fe9af935437fc070.yaml
+++ b/releasenotes/notes/enable-l3-port-forwarding-fe9af935437fc070.yaml
@@ -1,4 +1,5 @@
 ---
 features:
   - |
-    Neutron port_forwarding service plugin, and l3 extension can be enabled with variable enable_neutron_port_forwarding.
+    Neutron port_forwarding service plugin, and l3 extension can be enabled
+    with variable ``enable_neutron_port_forwarding``.
diff --git a/releasenotes/notes/external-mariadb-support-131440d3c984dd67.yaml b/releasenotes/notes/external-mariadb-support-131440d3c984dd67.yaml
index fe3f8dcf4e..aa5733506f 100644
--- a/releasenotes/notes/external-mariadb-support-131440d3c984dd67.yaml
+++ b/releasenotes/notes/external-mariadb-support-131440d3c984dd67.yaml
@@ -2,7 +2,11 @@
 features:
   - >
     [`blueprint external-mariadb-support <https://blueprints.launchpad.net/kolla-ansible/+spec/external-mariadb-support>`_]
-    Added External MariaDB server/cluster support
-  - Added enable_external_mariadb_load_balancer flag
-  - Added use_preconfigured_databases flag in order to add support for previously created databases / users
-  - Added use_common_mariadb_user in order to allow the use of a common database user across all databases
+    Added External MariaDB server/cluster support,
+  - Added ``enable_external_mariadb_load_balancer`` flag
+  - >
+    Added ``use_preconfigured_databases`` flag to support previously created
+    databases / users
+  - >
+    Added ``use_common_mariadb_user`` to allow use of a common database user
+    across all databases
diff --git a/releasenotes/notes/fix-ansible-warning-f9b382a13446f625.yaml b/releasenotes/notes/fix-ansible-warning-f9b382a13446f625.yaml
index 139d0906b5..37e3688bec 100644
--- a/releasenotes/notes/fix-ansible-warning-f9b382a13446f625.yaml
+++ b/releasenotes/notes/fix-ansible-warning-f9b382a13446f625.yaml
@@ -1,5 +1,5 @@
 ---
 fixes:
-  - fixed ansible warning when using ansible>2.2
-  - avoid using ansible reserved action and serial word in playbooks. use kolla_action and
-    kolla_serial instead.
+  - Fixed Ansible warning when using ansible>2.2. Avoid using Ansible reserved
+    action and serial word in playbooks. Use ``kolla_action`` and
+    ``kolla_serial`` instead.
diff --git a/releasenotes/notes/horizon_keystone_dropdown-6b9b4e5e9a64f979.yaml b/releasenotes/notes/horizon_keystone_dropdown-6b9b4e5e9a64f979.yaml
index 230bfa928d..0f09b341c7 100644
--- a/releasenotes/notes/horizon_keystone_dropdown-6b9b4e5e9a64f979.yaml
+++ b/releasenotes/notes/horizon_keystone_dropdown-6b9b4e5e9a64f979.yaml
@@ -2,6 +2,6 @@
 features:
   - |
     Added ``horizon_keystone_domain_choices`` hash. It can be used to set the
-    available domains to choose from on the horizon login page. This feature was introduced in
-    pike release.
-    https://docs.openstack.org/horizon/latest/configuration/settings.html#openstack-keystone-domain-choices
+    available domains to choose from on the horizon login page. This feature
+    was introduced in Pike release.
+    Please see `<https://docs.openstack.org/horizon/latest/configuration/settings.html#openstack-keystone-domain-choices>`__
diff --git a/releasenotes/notes/implement-ceph-nfs-ff8f9635c365923f.yaml b/releasenotes/notes/implement-ceph-nfs-ff8f9635c365923f.yaml
index 4f27e71a94..4fea7e98f4 100644
--- a/releasenotes/notes/implement-ceph-nfs-ff8f9635c365923f.yaml
+++ b/releasenotes/notes/implement-ceph-nfs-ff8f9635c365923f.yaml
@@ -1,5 +1,5 @@
 ---
 features:
   - |
-    Implement ceph-nfs service, Nfs-ganesha can be used as a proxy when mounting
-    ceph file shares.
+    Implement ``ceph-nfs`` service, ``nfs-ganesha`` can be used as a proxy when
+    mounting ceph file shares.
diff --git a/releasenotes/notes/masakari-ddd930cf5db5f713.yaml b/releasenotes/notes/masakari-ddd930cf5db5f713.yaml
index efa2d8b5b2..3efc4fda77 100644
--- a/releasenotes/notes/masakari-ddd930cf5db5f713.yaml
+++ b/releasenotes/notes/masakari-ddd930cf5db5f713.yaml
@@ -1,3 +1,4 @@
 ---
 features:
-  - Adds support for deploying Masakari, the instance high availability service.
+  - Adds support for deploying Masakari, the instance high availability
+    service.
diff --git a/releasenotes/notes/merge-neutron-vpnaas-role-with-neutron-l3-agent-90b91725344dda76.yaml b/releasenotes/notes/merge-neutron-vpnaas-role-with-neutron-l3-agent-90b91725344dda76.yaml
index 6e9f219f12..b3518b89fd 100644
--- a/releasenotes/notes/merge-neutron-vpnaas-role-with-neutron-l3-agent-90b91725344dda76.yaml
+++ b/releasenotes/notes/merge-neutron-vpnaas-role-with-neutron-l3-agent-90b91725344dda76.yaml
@@ -1,12 +1,13 @@
 ---
 upgrade:
   - |
-    The neutron-vpnaas-agent has been loaded just inside of the existing l3 agent
-    rather than requiring operators to run a completely different binary with a
-    subclass of the existing L3 agent.
+    The neutron-vpnaas-agent has been loaded just inside of the existing l3
+    agent rather than requiring operators to run a completely different
+    binary with a subclass of the existing L3 agent.
 
 deprecations:
   - |
-    As neutron-vpnaas-agent can be loaded by the neutron l3 agent, neutron-vpnaas
-    standalone mode is not supported. We have already removed the neutron-vpnaas-agent
-    container, currently, there is no need to keep this role.
+    As neutron-vpnaas-agent can be loaded by the neutron l3 agent,
+    neutron-vpnaas standalone mode is not supported. We have already removed
+    the neutron-vpnaas-agent container, currently, there is no need to keep
+    this role.
diff --git a/releasenotes/notes/move-vmware-password-parameters-to-passwords-yml-b6a375e0eb8cf27f.yaml b/releasenotes/notes/move-vmware-password-parameters-to-passwords-yml-b6a375e0eb8cf27f.yaml
index f7e3c355b6..fe28ac9210 100644
--- a/releasenotes/notes/move-vmware-password-parameters-to-passwords-yml-b6a375e0eb8cf27f.yaml
+++ b/releasenotes/notes/move-vmware-password-parameters-to-passwords-yml-b6a375e0eb8cf27f.yaml
@@ -1,5 +1,6 @@
 ---
 upgrade:
   - |
-    The vmware_dvs_host_password, vmware_nsxv_password, and vmware_vcenter_host_password
-    parameters moved to the passwords.yml file.
+    The ``vmware_dvs_host_password``, ``vmware_nsxv_password``, and
+    ``vmware_vcenter_host_password`` parameters moved to the ``passwords.yml``
+    file.
diff --git a/releasenotes/notes/opendaylight_release-removal-5077cd473bee6dbd.yaml b/releasenotes/notes/opendaylight_release-removal-5077cd473bee6dbd.yaml
index 81ab1c83ab..e6e6b90315 100644
--- a/releasenotes/notes/opendaylight_release-removal-5077cd473bee6dbd.yaml
+++ b/releasenotes/notes/opendaylight_release-removal-5077cd473bee6dbd.yaml
@@ -1,5 +1,5 @@
 ---
 features:
   - |
-    ``opendaylight_release`` variable is removed, version is discovered automatically
-    while booting features.
+    ``opendaylight_release`` variable is removed, version is discovered
+    automatically while booting features.
diff --git a/releasenotes/notes/prometheus-blackbox-exporter-ee096376656c3751.yaml b/releasenotes/notes/prometheus-blackbox-exporter-ee096376656c3751.yaml
index be0f9815f6..fc797b51b4 100644
--- a/releasenotes/notes/prometheus-blackbox-exporter-ee096376656c3751.yaml
+++ b/releasenotes/notes/prometheus-blackbox-exporter-ee096376656c3751.yaml
@@ -5,5 +5,5 @@ features:
 
     An example blackbox-exporter module has been added (disabled by default)
     called os_endpoint. This allows for the probing of endpoints over HTTP
-    and HTTPS. This can be used to monitor that OpenStack endpoints return a status
-    code of either 200 or 300, and the word 'versions' in the payload.
+    and HTTPS. This can be used to monitor that OpenStack endpoints return a
+    status code of either 200 or 300, and the word 'versions' in the payload.
diff --git a/releasenotes/notes/prometheus-config-when-alertmanager-disabled-0090c1570ff4e632.yaml b/releasenotes/notes/prometheus-config-when-alertmanager-disabled-0090c1570ff4e632.yaml
index 149055552b..9197fc0a32 100644
--- a/releasenotes/notes/prometheus-config-when-alertmanager-disabled-0090c1570ff4e632.yaml
+++ b/releasenotes/notes/prometheus-config-when-alertmanager-disabled-0090c1570ff4e632.yaml
@@ -2,7 +2,8 @@
 fixes:
   - |
     Fixes templating of Prometheus configuration when Alertmanager is disabled.
-    In a deployment where Prometheus is enabled and Alertmanager is disabled the
-    configuration for the Prometheus will fail when templating as the variable
-    `prometheus_alert_rules` does not contain the key `files`. For details
-    please see <https://bugs.launchpad.net/kolla-ansible/+bug/1854540>`__.
+    In a deployment where Prometheus is enabled and Alertmanager is disabled
+    the configuration for the Prometheus will fail when templating as the
+    variable ``prometheus_alert_rules`` does not contain the key ``files``.
+    For details please see
+    <https://bugs.launchpad.net/kolla-ansible/+bug/1854540>`__.
diff --git a/releasenotes/notes/remove-opendaylight-4caac9fbf25b8015.yaml b/releasenotes/notes/remove-opendaylight-4caac9fbf25b8015.yaml
index 270b560d31..f3d8fe5f4c 100644
--- a/releasenotes/notes/remove-opendaylight-4caac9fbf25b8015.yaml
+++ b/releasenotes/notes/remove-opendaylight-4caac9fbf25b8015.yaml
@@ -1,5 +1,5 @@
 ---
 upgrade:
   - |
-    Support for deployment of OpenDaylight controller and configuration of Neutron related to
-    integration with OpenDaylight have been removed.
+    Support for deployment of OpenDaylight controller and configuration of
+    Neutron related to integration with OpenDaylight have been removed.
diff --git a/releasenotes/notes/simplify-global-config-generation-8f42cea604ba1cf2.yaml b/releasenotes/notes/simplify-global-config-generation-8f42cea604ba1cf2.yaml
index 8e0c9e73da..1728b4e747 100644
--- a/releasenotes/notes/simplify-global-config-generation-8f42cea604ba1cf2.yaml
+++ b/releasenotes/notes/simplify-global-config-generation-8f42cea604ba1cf2.yaml
@@ -1,6 +1,7 @@
 ---
 upgrade:
   - |
-    The following files /etc/kolla/config/database.conf and /etc/kolla/config/messaging.conf
-    used to generate Openstack services config files are redundant with /etc/kolla/config/global.conf.
+    The following files ``/etc/kolla/config/database.conf`` and
+    ``/etc/kolla/config/messaging.conf`` used to generate Openstack services
+    files are redundant with ``/etc/kolla/config/global.conf``.
     They have been removed in order to simplify codebase.
diff --git a/releasenotes/notes/split_ovs_lb_agents_config-96f1f90e7d678209.yaml b/releasenotes/notes/split_ovs_lb_agents_config-96f1f90e7d678209.yaml
index 3bc5fa0a85..133d8c6755 100644
--- a/releasenotes/notes/split_ovs_lb_agents_config-96f1f90e7d678209.yaml
+++ b/releasenotes/notes/split_ovs_lb_agents_config-96f1f90e7d678209.yaml
@@ -6,9 +6,9 @@ upgrade:
     Please move your custom service config from ml2_conf.ini into those files.
 deprecations:
   - |
-    Customizing Neutron Linux bridge and Open vSwitch Agents config via ml2_conf.ini
-    is deprecated. The config has been split out for these agents into
-    linuxbridge_agent.ini and openvswitch_agent.ini respectively.
-    In this release (Ussuri) custom service config ml2_conf.ini overrides will still
-    be used when merging configs - but that functionality will be removed
-    in V release.
+    Customizing Neutron Linux bridge and Open vSwitch Agents config via
+    ``ml2_conf.ini`` is deprecated. The config has been split out for these
+    agents into ``linuxbridge_agent.ini`` and ``openvswitch_agent.ini``
+    respectively. In this release (Ussuri) custom service config
+    ``ml2_conf.ini`` overrides will still be used when merging configs - but
+    but that functionality will be removed in V release.
diff --git a/releasenotes/notes/standard-oslo-messaging-sections-4769da25bc58aa02.yaml b/releasenotes/notes/standard-oslo-messaging-sections-4769da25bc58aa02.yaml
index 0e21a5cc62..bb5006acc7 100644
--- a/releasenotes/notes/standard-oslo-messaging-sections-4769da25bc58aa02.yaml
+++ b/releasenotes/notes/standard-oslo-messaging-sections-4769da25bc58aa02.yaml
@@ -1,10 +1,11 @@
 ---
 features:
   - |
-    Adds a standardised method to configure notifications for different services.
+    Adds a standardised method to configure notifications for different
+    services.
 deprecations:
   - |
-    The ``enable_cadf_notifications`` variable is deprecated. CADF is the default
-    notification format in keystone. To enable keystone notifications, users should
-    now set ``keystone_default_notifications_topic_enabled`` to ``yes`` or enable
-    Ceilometer via ``enable_ceilometer``.
+    The ``enable_cadf_notifications`` variable is deprecated. CADF is the
+    default notification format in keystone. To enable keystone notifications,
+    users should now set ``keystone_default_notifications_topic_enabled`` to
+    ``yes`` or enable Ceilometer via ``enable_ceilometer``.
diff --git a/releasenotes/notes/support-ceph-dashboard-3ee5e489ea16ea25.yaml b/releasenotes/notes/support-ceph-dashboard-3ee5e489ea16ea25.yaml
index 7a3aea6332..0b58c50b6d 100644
--- a/releasenotes/notes/support-ceph-dashboard-3ee5e489ea16ea25.yaml
+++ b/releasenotes/notes/support-ceph-dashboard-3ee5e489ea16ea25.yaml
@@ -1,5 +1,5 @@
 ---
 features:
   - |
-    Add support for ceph-dashboard. It enables 'dashboard' module in ceph cluster.
-    Its uses command 'ceph mgr module enable dashboard'.
+    Add support for ceph-dashboard. It enables 'dashboard' module in ceph
+    cluster.
diff --git a/releasenotes/notes/swift-multi-policies-28bc322b54a82bf9.yaml b/releasenotes/notes/swift-multi-policies-28bc322b54a82bf9.yaml
index 3cacf42e78..ae312d5791 100644
--- a/releasenotes/notes/swift-multi-policies-28bc322b54a82bf9.yaml
+++ b/releasenotes/notes/swift-multi-policies-28bc322b54a82bf9.yaml
@@ -1,6 +1,6 @@
 ---
 features:
   - |
-    Adds a new variable to be used by the swift role, ``swift_extra_ring_files``.
-    It allows to pass additional ring files to be deployed in the context of
-    a multi-policy setup.
+    Adds a new variable to be used by the swift role,
+    ``swift_extra_ring_files``. It allows to pass additional ring files to be
+    deployed in the context of a multi-policy setup.
diff --git a/releasenotes/notes/swift-replication-network-40ecd13e4339f299.yaml b/releasenotes/notes/swift-replication-network-40ecd13e4339f299.yaml
index ad6d8edf95..de806e069f 100644
--- a/releasenotes/notes/swift-replication-network-40ecd13e4339f299.yaml
+++ b/releasenotes/notes/swift-replication-network-40ecd13e4339f299.yaml
@@ -16,8 +16,8 @@ features:
     ``swift_replication_interface``, which defaults to
     ``swift_storage_interface``.
 
-    If a separate replication network is used, Kolla Ansible now deploys separate
-    replication servers for the accounts, containers and objects, that listen on
-    this network. In this case, these services handle only replication traffic, and
-    the original account-, container- and object- servers only handle storage
-    user requests.
+    If a separate replication network is used, Kolla Ansible now deploys
+    separate replication servers for the accounts, containers and objects,
+    that listen on this network. In this case, these services handle only
+    replication traffic, and the original account-, container- and object-
+    servers only handle storage user requests.
diff --git a/releasenotes/notes/swift-s3api-2b51917b169fff78.yaml b/releasenotes/notes/swift-s3api-2b51917b169fff78.yaml
index ac9af5e097..12b884724a 100644
--- a/releasenotes/notes/swift-s3api-2b51917b169fff78.yaml
+++ b/releasenotes/notes/swift-s3api-2b51917b169fff78.yaml
@@ -1,4 +1,5 @@
 ---
 features:
   - |
-    Adds support for the Swift S3 API, enabled via the ``enable_swift_s3api`` flag.
+    Adds support for the Swift S3 API, enabled via the ``enable_swift_s3api``
+    flag.
diff --git a/tox.ini b/tox.ini
index 85f9db5083..aab0805429 100644
--- a/tox.ini
+++ b/tox.ini
@@ -46,6 +46,7 @@ commands =
   {toxinidir}/tools/run-bashate.sh
   flake8 {posargs}
   doc8 doc/source
+  doc8 -e '.yaml' releasenotes/notes/
   python {toxinidir}/tools/validate-all-file.py
   bandit --skip B303 -r ansible kolla_ansible tests tools
   yamllint -s .