Merge "Tidy up release notes for Ussuri"

20 files changed, 47 insertions, 47 deletions

diff --git a/releasenotes/notes/add-networking-mlnx-to-neutron-base-2c39f761dbf8fa7d.yaml b/releasenotes/notes/add-networking-mlnx-to-neutron-base-2c39f761dbf8fa7d.yaml
index 0d3e8caa2..5200367da 100644
--- a/releasenotes/notes/add-networking-mlnx-to-neutron-base-2c39f761dbf8fa7d.yaml
+++ b/releasenotes/notes/add-networking-mlnx-to-neutron-base-2c39f761dbf8fa7d.yaml
@@ -2,6 +2,7 @@
 
 features:
   - |
-    Add Networking-MLNX package to Neutron-Base image, the package is required
-    for infiniband deployment to be installed on containers: neutron-server,
-    neutron-dhcp-agent and neutron-l3-agent.
+    Adds the ``networking-mlnx`` package to the ``neutron-base`` image. The
+    package is required for InfiniBand deployment, and is used by the
+    ``neutron-server``, ``neutron-dhcp-agent`` and ``neutron-l3-agent``
+    containers.
diff --git a/releasenotes/notes/add-neutron-mlnx-agent-b77a4ad9ba3beaae.yaml b/releasenotes/notes/add-neutron-mlnx-agent-b77a4ad9ba3beaae.yaml
index 40ea3da46..1f7f80e67 100644
--- a/releasenotes/notes/add-neutron-mlnx-agent-b77a4ad9ba3beaae.yaml
+++ b/releasenotes/notes/add-neutron-mlnx-agent-b77a4ad9ba3beaae.yaml
@@ -1,4 +1,4 @@
 ---
 features:
   - |
-    Adds Neutron Mellanox agent image.
+    Adds a ``neutron-mlnx-agent`` image for the Neutron Mellanox agent.
diff --git a/releasenotes/notes/add-quiet-mode-4f386acd4bc043a5.yaml b/releasenotes/notes/add-quiet-mode-4f386acd4bc043a5.yaml
index f06db63c9..8bbff16ea 100644
--- a/releasenotes/notes/add-quiet-mode-4f386acd4bc043a5.yaml
+++ b/releasenotes/notes/add-quiet-mode-4f386acd4bc043a5.yaml
@@ -1,4 +1,4 @@
 ---
 features:
   - |
-    Adds '--quiet' switch to disable printing of image build log.
+    Adds ``--quiet`` switch to disable printing of image build logs.
diff --git a/releasenotes/notes/add_dpdk_telemetry_and_logparser-bcf9b13bcefc99c9.yaml b/releasenotes/notes/add_dpdk_telemetry_and_logparser-bcf9b13bcefc99c9.yaml
index d970346f4..1a620fc54 100644
--- a/releasenotes/notes/add_dpdk_telemetry_and_logparser-bcf9b13bcefc99c9.yaml
+++ b/releasenotes/notes/add_dpdk_telemetry_and_logparser-bcf9b13bcefc99c9.yaml
@@ -3,6 +3,6 @@
 features:
   - |
     Adds ``collectd-dpdk_telemetry`` and ``collectd-logparser`` packages
-    to ``collectd`` RHEL-based image. dpdk_telemetry plugin collects DPDK
-    ethernet device metrics via dpdk_telemetry library. Logparser is
-    plugin for filtering and parsing log messages.
+    to ``collectd`` RHEL-based image. The ``dpdk_telemetry`` plugin collects
+    DPDK Ethernet device metrics via the ``dpdk_telemetry`` library.
+    ``logparser`` is a plugin for filtering and parsing log messages.
diff --git a/releasenotes/notes/allow-custom-ceilometer-upgrade-params-7c08446f59251cf0.yaml b/releasenotes/notes/allow-custom-ceilometer-upgrade-params-7c08446f59251cf0.yaml
index 2e8073080..49fbf218d 100644
--- a/releasenotes/notes/allow-custom-ceilometer-upgrade-params-7c08446f59251cf0.yaml
+++ b/releasenotes/notes/allow-custom-ceilometer-upgrade-params-7c08446f59251cf0.yaml
@@ -1,12 +1,11 @@
 ---
 features:
   - |
-    Allow operators to use custom parameters with the ceilometer-upgrade
+    Allow operators to use custom parameters with the ``ceilometer-upgrade``
     command. This is quite useful when using the dynamic pollster subsystem;
     that sub-system provides flexibility to create and edit pollsters configs,
-    which affects gnocchi resource-type configurations. However, Ceilometer
+    which affects Gnocchi resource-type configurations. However, Ceilometer
     uses default and hard-coded resource-type configurations; if one customizes
-    some of its default resource-types, he/she can get into trouble during
+    some of its default resource-types, they can get into trouble during
     upgrades. Therefore, the only way to work around it is to use the
-    "--skip-gnocchi-resource-types" flag. This release introduces a method for
-    operators to execute such customization, and many others if needed.
+    ``--skip-gnocchi-resource-types`` flag.
diff --git a/releasenotes/notes/base-unified-07fe64b8cbbdab9a.yaml b/releasenotes/notes/base-unified-07fe64b8cbbdab9a.yaml
index 951f4b9c6..ef39c98b1 100644
--- a/releasenotes/notes/base-unified-07fe64b8cbbdab9a.yaml
+++ b/releasenotes/notes/base-unified-07fe64b8cbbdab9a.yaml
@@ -1,5 +1,5 @@
 ---
 deprecations:
   - |
-    Deprecate 'centos_binary_packages' and 'centos_source_packages' overrides in
-    favour of 'centos_packages' list.
+    Deprecates the ``centos_binary_packages`` and ``centos_source_packages``
+    overrides in favour of ``centos_packages``.
diff --git a/releasenotes/notes/bug-1867365-115d717288e7c7d0.yaml b/releasenotes/notes/bug-1867365-115d717288e7c7d0.yaml
index 5e6c71a69..4ea54fa0b 100644
--- a/releasenotes/notes/bug-1867365-115d717288e7c7d0.yaml
+++ b/releasenotes/notes/bug-1867365-115d717288e7c7d0.yaml
@@ -1,6 +1,6 @@
 ---
 fixes:
   - |
-    Fixes nova-libvirt networking failures on AArch64 (ARM64) servers running
-    on ThunderX CPUs.
-    `LP#1867365 <https://launchpad.net/bugs/1867365>`__
+    Fixes ``nova-libvirt`` networking failures on AArch64 (ARM64) servers
+    running on ThunderX CPUs.  `LP#1867365
+    <https://launchpad.net/bugs/1867365>`__
diff --git a/releasenotes/notes/centos8-aarch64-not-part-of-release-330893c1f7d5f394.yaml b/releasenotes/notes/centos8-aarch64-not-part-of-release-330893c1f7d5f394.yaml
index 5ba440b3d..c0c123a9c 100644
--- a/releasenotes/notes/centos8-aarch64-not-part-of-release-330893c1f7d5f394.yaml
+++ b/releasenotes/notes/centos8-aarch64-not-part-of-release-330893c1f7d5f394.yaml
@@ -2,4 +2,4 @@
 issues:
   - |
     AArch64 images using CentOS as base system are not supported in Ussuri.
-    This will be fixed later in release cycle as we need CentOS 8.2 release.
+    This may be fixed when CentOS 8.2 is released.
diff --git a/releasenotes/notes/deprecate-neutron-server-ovn-8aee98fc5923e886.yaml b/releasenotes/notes/deprecate-neutron-server-ovn-8aee98fc5923e886.yaml
index 721b99394..f55a3bcee 100644
--- a/releasenotes/notes/deprecate-neutron-server-ovn-8aee98fc5923e886.yaml
+++ b/releasenotes/notes/deprecate-neutron-server-ovn-8aee98fc5923e886.yaml
@@ -2,6 +2,6 @@
 deprecations:
   - |
     The ``neutron-server-ovn`` and ``neutron-metadata-agent-ovn`` images are
-    deprecated and will be removed in the V cycle. OVN drivers and
+    deprecated and will be removed in the Victoria release. OVN drivers and
     networking-ovn-metadata-agent have been moved to ``neutron-base`` image
     and are available in ``neutron-server`` and ``neutron-metadata-agent``.
diff --git a/releasenotes/notes/drop-py27-a16f4712ac89e3a9.yaml b/releasenotes/notes/drop-py27-a16f4712ac89e3a9.yaml
index ea09134c4..4117ea433 100644
--- a/releasenotes/notes/drop-py27-a16f4712ac89e3a9.yaml
+++ b/releasenotes/notes/drop-py27-a16f4712ac89e3a9.yaml
@@ -1,6 +1,6 @@
 ---
 upgrade:
   - |
-    Python 2.7 support has been dropped. Last release of kolla to support
+    Python 2.7 support has been dropped. The last release of Kolla to support
     Python 2.7 is OpenStack Train. The minimum version of Python now supported
-    by kolla is Python 3.6.
+    by Kolla is Python 3.6.
diff --git a/releasenotes/notes/enable-repos-when-needed-3beac8e1e24ea8eb.yaml b/releasenotes/notes/enable-repos-when-needed-3beac8e1e24ea8eb.yaml
index 2bf7d533e..a82837b19 100644
--- a/releasenotes/notes/enable-repos-when-needed-3beac8e1e24ea8eb.yaml
+++ b/releasenotes/notes/enable-repos-when-needed-3beac8e1e24ea8eb.yaml
@@ -2,6 +2,6 @@
 upgrade:
   - |
     The way of handling external repositories has changed. All such repos are
-    now disabled by default. There is "enable_extra_repos" macro to enable them
-    by name. Repositories names are defined in the "kolla/templates/repos.yaml"
-    file.
+    now disabled by default. The ``enable_extra_repos`` macro is used to enable
+    them by name. Repositories names are defined in the
+    ``kolla/templates/repos.yaml`` file.
diff --git a/releasenotes/notes/netcontrold-24c9d6602f84e819.yaml b/releasenotes/notes/netcontrold-24c9d6602f84e819.yaml
index a4f9e6b6b..75e993a57 100644
--- a/releasenotes/notes/netcontrold-24c9d6602f84e819.yaml
+++ b/releasenotes/notes/netcontrold-24c9d6602f84e819.yaml
@@ -1,3 +1,3 @@
 ---
 features:
-    - Adds possibility to run netcontrold image for openvswitch service.
+  - Adds a ``netcontrold`` image for Open vSwitch.
diff --git a/releasenotes/notes/new-kolla-options-e8e32357786e8454.yaml b/releasenotes/notes/new-kolla-options-e8e32357786e8454.yaml
index 966d74215..b0b2e249d 100644
--- a/releasenotes/notes/new-kolla-options-e8e32357786e8454.yaml
+++ b/releasenotes/notes/new-kolla-options-e8e32357786e8454.yaml
@@ -1,14 +1,14 @@
 ---
 features:
   - |
-    Adds `--enable-unbuildable` options to ignore internal list of unbuildable
-    images. It is useful in two situations: building for new
+    Adds an `--enable-unbuildable` option to ignore the internal list of
+    unbuildable images. It is useful in two situations: building for a new
     distribution/architecture or generation of templates (with
-    '--templates-only' option) when all templates are needed no matter being
+    ``--templates-only`` option) when all templates are needed no matter being
     buildable or not.
 
 upgrade:
   - |
-    The way of generating templates (with '--templates-only' option) is changed.
-    By default only buildable ones are generated. If all templates are needed
-    then '--enable-unbuildable' option must be used.
+    The way of generating templates (with ``--templates-only`` option) is
+    changed.  By default only buildable ones are generated. If all templates
+    are needed then ``--enable-unbuildable`` option must be used.
diff --git a/releasenotes/notes/nova-compute-add-ndctl-811f923d81bbd6ac.yaml b/releasenotes/notes/nova-compute-add-ndctl-811f923d81bbd6ac.yaml
index f8b57ca06..64cfa517f 100644
--- a/releasenotes/notes/nova-compute-add-ndctl-811f923d81bbd6ac.yaml
+++ b/releasenotes/notes/nova-compute-add-ndctl-811f923d81bbd6ac.yaml
@@ -1,5 +1,5 @@
 ---
 features:
   - |
-    Adding `ndctl` package to nova-compute to expose NVDIMM namespaces
-    to guests. The package is needed to manage PMEM namespaces.
+    Adding ``ndctl`` package to the ``nova-compute`` image to expose NVDIMM
+    namespaces to guests. The package is needed to manage PMEM namespaces.
diff --git a/releasenotes/notes/remove-ceph-afff3cd8775e3a41.yaml b/releasenotes/notes/remove-ceph-afff3cd8775e3a41.yaml
index f1ad79a95..3295614dd 100644
--- a/releasenotes/notes/remove-ceph-afff3cd8775e3a41.yaml
+++ b/releasenotes/notes/remove-ceph-afff3cd8775e3a41.yaml
@@ -2,5 +2,5 @@
 upgrade:
   - |
     Kolla Ceph container images have been removed. Please use
-    other source of Ceph container images, such as `ceph-container
+    another source of Ceph container images, such as `ceph-container
     <https://github.com/ceph/ceph-container>`__
diff --git a/releasenotes/notes/remove-monasca-log-api-199dc88030284e71.yaml b/releasenotes/notes/remove-monasca-log-api-199dc88030284e71.yaml
index d077f9e49..29968254c 100644
--- a/releasenotes/notes/remove-monasca-log-api-199dc88030284e71.yaml
+++ b/releasenotes/notes/remove-monasca-log-api-199dc88030284e71.yaml
@@ -2,4 +2,8 @@
 upgrade:
   - |
     The Monasca Log API merged into the Monasca API codebase in the Train
-    release and the monasca-log-api image has therefore been removed.
+    release and the ``monasca-log-api`` image has therefore been removed.
+  - |
+    As part of the support for using the unified Monasca API for logs, the
+    Fluentd Monasca output plugin has been upgraded. Any custom Fluentd
+    configuration which forwards logs to Monasca will need to be updated.
diff --git a/releasenotes/notes/skydive-remove-58bbea2626c59aea.yaml b/releasenotes/notes/skydive-remove-58bbea2626c59aea.yaml
index 882037a90..de605fb07 100644
--- a/releasenotes/notes/skydive-remove-58bbea2626c59aea.yaml
+++ b/releasenotes/notes/skydive-remove-58bbea2626c59aea.yaml
@@ -1,5 +1,6 @@
 ---
 upgrade:
   - |
-    Remove of Skydive image for aarch64 and ppc64le. Upstream builds own images
-    for wide selection of architectures. Binaries are provided only for x86-64.
+    Support for Skydive images for aarch64 and ppc64le has been dropped.
+    Upstream builds own images for a wide selection of architectures. Binaries
+    are provided only for x86-64.
diff --git a/releasenotes/notes/ubuntu-uses-mirrors-now-0858d579944eea48.yaml b/releasenotes/notes/ubuntu-uses-mirrors-now-0858d579944eea48.yaml
index aa5d418ea..71355242d 100644
--- a/releasenotes/notes/ubuntu-uses-mirrors-now-0858d579944eea48.yaml
+++ b/releasenotes/notes/ubuntu-uses-mirrors-now-0858d579944eea48.yaml
@@ -1,5 +1,5 @@
 ---
 upgrade:
   - |
-    Ubuntu based images use APT mirrors now. May affect builds done behind http
+    Ubuntu based images use APT mirrors now. This may affect builds behind HTTP
     proxies.
diff --git a/releasenotes/notes/upgrade_fluentd_output_plugin-d46df19aa4def17c.yaml b/releasenotes/notes/upgrade_fluentd_output_plugin-d46df19aa4def17c.yaml
deleted file mode 100644
index 0e0e9094c..000000000
--- a/releasenotes/notes/upgrade_fluentd_output_plugin-d46df19aa4def17c.yaml
+++ /dev/null
@@ -1,6 +0,0 @@
----
-upgrade:
-  - |
-    As part of the support for using the unified Monasca API for logs, the
-    Fluentd Monasca output plugin has been upgraded. Any custom Fluentd
-    configuration which forwards logs to Monasca will need to be updated.
diff --git a/releasenotes/notes/use-upstream-dumb-init-032708cd3ad5792f.yaml b/releasenotes/notes/use-upstream-dumb-init-032708cd3ad5792f.yaml
index 36c603159..2e34a8ee1 100644
--- a/releasenotes/notes/use-upstream-dumb-init-032708cd3ad5792f.yaml
+++ b/releasenotes/notes/use-upstream-dumb-init-032708cd3ad5792f.yaml
@@ -1,5 +1,6 @@
 ---
 upgrade:
   - |
-    Use upstream binaries of 'dumb-init' on all supported architectures. Drop support for
-    'base_compiler_packages' list as it is no longer needed.
+    Switches to use upstream binaries of ``dumb-init`` on all supported
+    architectures. Drops support for the ``base_compiler_packages`` override
+    list as it is no longer needed.