Tidy up release notes for Stein 8.0.0 release

Change-Id: I9615bc26156a26616dea083c3db4efbf7717231c

24 files changed, 71 insertions, 58 deletions

diff --git a/releasenotes/notes/Add-distro_python_version-variable-3688288558f4e586.yaml b/releasenotes/notes/Add-distro_python_version-variable-3688288558f4e586.yaml
index a218da9f7..b433b7bdb 100644
--- a/releasenotes/notes/Add-distro_python_version-variable-3688288558f4e586.yaml
+++ b/releasenotes/notes/Add-distro_python_version-variable-3688288558f4e586.yaml
@@ -1,6 +1,7 @@
 ---
 features:
   - |
-    New variable 'distro_python_version' to store version of Python used in
-    distribution used as a base. Can be used to handle py2/py3 checks and to
-    find 'site-packages' directory.
+    Adds a new variable ``distro_python_version`` to store the version of
+    Python used in the OS distribution used as a base. Can be used to handle
+    checks for python 2 or 3 checks and to find the ``site-packages``
+    directory.
diff --git a/releasenotes/notes/add-crane-image-c6b381b2a6ce62d2.yaml b/releasenotes/notes/add-crane-image-c6b381b2a6ce62d2.yaml
deleted file mode 100644
index 4ba300a77..000000000
--- a/releasenotes/notes/add-crane-image-c6b381b2a6ce62d2.yaml
+++ /dev/null
@@ -1,3 +0,0 @@
----
-features:
-  - Add crane image. Crane is a lightweight 'pull only' container registry implementation.
diff --git a/releasenotes/notes/add-cyborg-images-cab2b3a24a071c38.yaml b/releasenotes/notes/add-cyborg-images-cab2b3a24a071c38.yaml
index a1e68103f..0f1a835e0 100644
--- a/releasenotes/notes/add-cyborg-images-cab2b3a24a071c38.yaml
+++ b/releasenotes/notes/add-cyborg-images-cab2b3a24a071c38.yaml
@@ -1,3 +1,4 @@
 ---
 features:
-  - Cyborg Docker images are available in Kolla
+  - Adds Cyborg images. Cyborg is an OpenStack service for managing hardware
+    accelerators.
diff --git a/releasenotes/notes/add-debian_arch-variable-9559ac31809afaca.yaml b/releasenotes/notes/add-debian_arch-variable-9559ac31809afaca.yaml
index 7f8a26f16..31ee2ace2 100644
--- a/releasenotes/notes/add-debian_arch-variable-9559ac31809afaca.yaml
+++ b/releasenotes/notes/add-debian_arch-variable-9559ac31809afaca.yaml
@@ -1,7 +1,7 @@
 ---
 features:
   - |
-    Add `debian_arch` variable which can be used in Dockerfile.j2 files instead
-    of checking architecture names. For 'x86-64' it goes for 'amd64' and uses
-    'arm64' on 'aarch64' architecture. This is handy for fetching external
-    release files.
+    Adds a ``debian_arch`` variable which can be used in Dockerfile.j2 files
+    instead of checking architecture names. For 'x86-64' it has a value of
+    'amd64' and uses 'arm64' on 'aarch64' architecture. This is handy for
+    fetching external release files.
diff --git a/releasenotes/notes/add-monasca-grafana-868f1dd95725a030.yaml b/releasenotes/notes/add-monasca-grafana-868f1dd95725a030.yaml
index 1ec5d6833..c371ec8f0 100644
--- a/releasenotes/notes/add-monasca-grafana-868f1dd95725a030.yaml
+++ b/releasenotes/notes/add-monasca-grafana-868f1dd95725a030.yaml
@@ -1,6 +1,6 @@
 ---
 features:
   - |
-    Add the Monasca fork of Grafana (v4.0.1). The Monasca fork of Grafana
-    adds Keystone integration, allowing Grafana users to log in with their
-    OpenStack credentials and see Metrics from their OpenStack project.
+    Adds an image for the Monasca fork of Grafana (v4.0.1). The Monasca fork of
+    Grafana adds Keystone integration, allowing Grafana users to log in with
+    their OpenStack credentials and see Metrics from their OpenStack project.
diff --git a/releasenotes/notes/add-mtail-b806e87da3ae950d.yaml b/releasenotes/notes/add-mtail-b806e87da3ae950d.yaml
index cef37f96c..cc930f35d 100644
--- a/releasenotes/notes/add-mtail-b806e87da3ae950d.yaml
+++ b/releasenotes/notes/add-mtail-b806e87da3ae950d.yaml
@@ -1,5 +1,5 @@
 ---
 features:
   - |
-    Add mtail, a utility for turning logs into metrics for use with
-    Prometheus.
+    Adds an image for Prometheus mtail. Mtail is a utility for turning logs
+    into metrics in Prometheus.
diff --git a/releasenotes/notes/add-tripleoclient-image-0341fb72fe27ba14.yaml b/releasenotes/notes/add-tripleoclient-image-0341fb72fe27ba14.yaml
index 5033c4c41..ef58c962b 100644
--- a/releasenotes/notes/add-tripleoclient-image-0341fb72fe27ba14.yaml
+++ b/releasenotes/notes/add-tripleoclient-image-0341fb72fe27ba14.yaml
@@ -1,5 +1,5 @@
 ---
 features:
-  - Add tripleoclient image. This image can be used interactively for ad-hoc
-    tripleoclient commands or automated to output Ansible playbooks from
+  - Adds a ``tripleoclient`` image. This image can be used interactively for
+    ad-hoc tripleoclient commands or automated to output Ansible playbooks from
     TripleO Heat Templates for TripleO deployment.
diff --git a/releasenotes/notes/add_trousers_to_nova_libvirt-4d159df1079b5c8e.yaml b/releasenotes/notes/add_trousers_to_nova_libvirt-4d159df1079b5c8e.yaml
deleted file mode 100644
index eae591fc0..000000000
--- a/releasenotes/notes/add_trousers_to_nova_libvirt-4d159df1079b5c8e.yaml
+++ /dev/null
@@ -1,6 +0,0 @@
----
-fixes:
-  - |
-    The user tss is wanted by libvirt and comes with the trousers package.
-    Prior RHEL8 it comes via the gnutls -> trousers dependencies, but there is
-    no such a dependency in RHEL8, so make sure we have trousers installed.
diff --git a/releasenotes/notes/base-package-type-bf53d8d63611b5ac.yaml b/releasenotes/notes/base-package-type-bf53d8d63611b5ac.yaml
index c072ead29..6a8ee4290 100644
--- a/releasenotes/notes/base-package-type-bf53d8d63611b5ac.yaml
+++ b/releasenotes/notes/base-package-type-bf53d8d63611b5ac.yaml
@@ -1,7 +1,7 @@
 ---
 features:
   - |
-    Add `base_package_type` which can be used in Dockerfile.j2 files instead
-    of checking based on distro names. This will default to "rpm" for RHEL
-    based distros and "deb" for Debian based systems. This can also be overriden
-    to any string value via a configuration file.
+    Adds a ``base_package_type`` configuration option which will default to
+    ``rpm`` for RHEL-based distros and ``deb`` for Debian-based systems. This
+    can be used in Dockerfile.j2 files instead of checking based on distro
+    names.
diff --git a/releasenotes/notes/clean_package_cache-fa08d1808a2f2b49.yaml b/releasenotes/notes/clean_package_cache-fa08d1808a2f2b49.yaml
index 84a0800c5..163628b14 100644
--- a/releasenotes/notes/clean_package_cache-fa08d1808a2f2b49.yaml
+++ b/releasenotes/notes/clean_package_cache-fa08d1808a2f2b49.yaml
@@ -1,6 +1,6 @@
 ---
 features:
   - |
-    clean_package_cache is a parameter (set to True by default for backward
-    compatibility) that controls the package cache cleaning when building the
-    images.
+    Add a ``clean_package_cache`` configuration option, set to True by default
+    for backward compatibility. This option controls the package cache cleaning
+    when building the images.
diff --git a/releasenotes/notes/debian-buster-7bd8be7ec4ce0d13.yaml b/releasenotes/notes/debian-buster-7bd8be7ec4ce0d13.yaml
index 6b867f7bd..1672e39b0 100644
--- a/releasenotes/notes/debian-buster-7bd8be7ec4ce0d13.yaml
+++ b/releasenotes/notes/debian-buster-7bd8be7ec4ce0d13.yaml
@@ -1,5 +1,6 @@
 ---
 features:
-    - Debian 'buster' (next stable release, now in 'freeze' state) is now used
-      instead of 'stretch'.
-    - Several images got enabled for Debian.
+  - |
+    Debian 'buster' is now used instead of 'stretch'. Buster is the next stable
+    release of Debian, and is currently in a 'freeze' state. Several images
+    gained Debian support with the move to buster.
diff --git a/releasenotes/notes/distro-package-manager-49634f537be63036.yaml b/releasenotes/notes/distro-package-manager-49634f537be63036.yaml
index 069f6fedb..05b280396 100644
--- a/releasenotes/notes/distro-package-manager-49634f537be63036.yaml
+++ b/releasenotes/notes/distro-package-manager-49634f537be63036.yaml
@@ -1,7 +1,7 @@
 ---
 features:
   - |
-    Added `distro_package_manager` configuration that can be used to specify
-    which package manager commands should be used for a given operating system.
-    This only works for like type of packaging systems like 'dnf' vs 'yum' for
-    'rpm' package types.
+    Adds a ``distro_package_manager`` configuration option that can be used to
+    specify which package manager commands should be used for a given operating
+    system. The default value is ``dnf`` for RHEL 8 or Fedora, ``yum`` for
+    other RHEL-based systems, or ``apt`` for Debian-based systems.
diff --git a/releasenotes/notes/do-not-load-modules-9b651e40d3479c39.yaml b/releasenotes/notes/do-not-load-modules-9b651e40d3479c39.yaml
index 87c1ac0ae..f72f22587 100644
--- a/releasenotes/notes/do-not-load-modules-9b651e40d3479c39.yaml
+++ b/releasenotes/notes/do-not-load-modules-9b651e40d3479c39.yaml
@@ -1,4 +1,4 @@
 ---
 upgrade:
-  - Remove kernel module loading from within containers. This must now be done
-    on the host directly.
+  - Removes kernel module loading from startup scripts packaged with the
+    images. Kernel modules must now be loaded on the host directly.
diff --git a/releasenotes/notes/get_pip-macro-906a78462b216049.yaml b/releasenotes/notes/get_pip-macro-906a78462b216049.yaml
index f4ed0d92b..a8f534b18 100644
--- a/releasenotes/notes/get_pip-macro-906a78462b216049.yaml
+++ b/releasenotes/notes/get_pip-macro-906a78462b216049.yaml
@@ -1,4 +1,4 @@
 ---
 features:
   - |
-    New macro: 'get_pip' allows to bootstrap 'pip' in image.
+    Adds a new ``get_pip`` macro that allows to bootstrap 'pip' in image.
diff --git a/releasenotes/notes/mariadb-dumb-init-b23949398fd44021.yaml b/releasenotes/notes/mariadb-dumb-init-b23949398fd44021.yaml
new file mode 100644
index 000000000..afe2e92c9
--- /dev/null
+++ b/releasenotes/notes/mariadb-dumb-init-b23949398fd44021.yaml
@@ -0,0 +1,7 @@
+---
+upgrade:
+  - |
+    The ``mariadb`` image has been modified to use a different ENTRYPOINT that
+    avoids passing a ``--single-child`` argument to ``dumb-init``. This
+    entrypoint is enclosed in a Jinja2 block called ``mariadb_entrypoint`` that
+    allows it to be overridden if necessary.
diff --git a/releasenotes/notes/remove-neutron-sfc-agent-181ec5dbc52ac1da.yaml b/releasenotes/notes/remove-neutron-sfc-agent-181ec5dbc52ac1da.yaml
index 6933fd06b..b806ca853 100644
--- a/releasenotes/notes/remove-neutron-sfc-agent-181ec5dbc52ac1da.yaml
+++ b/releasenotes/notes/remove-neutron-sfc-agent-181ec5dbc52ac1da.yaml
@@ -1,5 +1,5 @@
 ---
 other:
   - |
-    The neutron-sfc-agent was removed. It was deprecated and marked for
+    Removes the ``neutron-sfc-agent`` image. It was deprecated and marked for
     removal during Queens release.
diff --git a/releasenotes/notes/remove-vitrage-collector-ed76366b9bb6e8e8.yaml b/releasenotes/notes/remove-vitrage-collector-ed76366b9bb6e8e8.yaml
index 23798c51a..089b16db9 100644
--- a/releasenotes/notes/remove-vitrage-collector-ed76366b9bb6e8e8.yaml
+++ b/releasenotes/notes/remove-vitrage-collector-ed76366b9bb6e8e8.yaml
@@ -1,5 +1,5 @@
 ---
-deprecations:
+other:
   - |
     The ``vitrage-collector`` service has been removed by the Vitrage project,
     so the ``vitrage-collector`` image has been removed from Kolla.
diff --git a/releasenotes/notes/rhel-python3-support-1078f829dc42c4d6.yaml b/releasenotes/notes/rhel-python3-support-1078f829dc42c4d6.yaml
index 4c27f1a83..e300cf15a 100644
--- a/releasenotes/notes/rhel-python3-support-1078f829dc42c4d6.yaml
+++ b/releasenotes/notes/rhel-python3-support-1078f829dc42c4d6.yaml
@@ -1,6 +1,5 @@
 ---
 features:
   - |
-    Added initial support for python3 packages for RHEL systems provided by
-    RDO. To enable the use of the python3 packages, set distro_python3 to True
-    and use a python 3.6 RHEL compatible base.
+    Adds initial support for python 3 packages for RHEL systems provided by
+    RDO.
diff --git a/releasenotes/notes/sahara-split-plugins-66e31717b7c24472.yaml b/releasenotes/notes/sahara-split-plugins-66e31717b7c24472.yaml
index 3d654ad4d..1906a23c5 100644
--- a/releasenotes/notes/sahara-split-plugins-66e31717b7c24472.yaml
+++ b/releasenotes/notes/sahara-split-plugins-66e31717b7c24472.yaml
@@ -1,7 +1,11 @@
 ---
 features:
   - |
-    Add support for the Sahara plugins, which are provided separately
-    from the core since Stein. The currently supported methods are
-    source (through the `sahara_base_packages` variable) and RPM
-    (through the dedicated `sahara_base_plugins_pip_packages`.)
+    Adds support for the Sahara plugins, which are provided separately from the
+    core since the Stein release. The currently supported methods are source
+    (through the ``sahara_base_packages`` variable) and RPM (through the
+    dedicated ``sahara_base_plugins_pip_packages``.)
+issues:
+  - |
+    Sahara plugins are no longer provided in Ubuntu binary images, since they
+    were not packaged by the distribution in time for the Kolla Stein release.
diff --git a/releasenotes/notes/split-placement-from-nova-27b7ea2359c2d3ae.yaml b/releasenotes/notes/split-placement-from-nova-27b7ea2359c2d3ae.yaml
index 1281537c2..ca3f2dbce 100644
--- a/releasenotes/notes/split-placement-from-nova-27b7ea2359c2d3ae.yaml
+++ b/releasenotes/notes/split-placement-from-nova-27b7ea2359c2d3ae.yaml
@@ -1,7 +1,8 @@
 ---
 features:
   - |
-    Nova placement API has been moved into its own images.
+    The placement API has been moved into its own images, since it has been
+    extracted from Nova into a separate project.
 upgrade:
   - |
-    nova-placement-api image will be renamed to placement-api.
+    The ``nova-placement-api`` image has been renamed to ``placement-api``.
diff --git a/releasenotes/notes/stein-prelude-92e47ccd60c76325.yaml b/releasenotes/notes/stein-prelude-92e47ccd60c76325.yaml
new file mode 100644
index 000000000..d2bafde20
--- /dev/null
+++ b/releasenotes/notes/stein-prelude-92e47ccd60c76325.yaml
@@ -0,0 +1,7 @@
+---
+prelude: |
+  The Kolla ``8.0.0`` release is the first release in the Stein cycle.
+  Highlights include full support for the OpenStack Monasca project,
+  support for the Placement service which has been extracted from Nova,
+  and an ``xtrabackup`` image for taking database backups. This release
+  also lays the groundwork for Python 3 support in the Train release.
diff --git a/releasenotes/notes/update-zaqar-images-95a5909b48893698.yaml b/releasenotes/notes/update-zaqar-images-95a5909b48893698.yaml
index 72d681778..077488f51 100644
--- a/releasenotes/notes/update-zaqar-images-95a5909b48893698.yaml
+++ b/releasenotes/notes/update-zaqar-images-95a5909b48893698.yaml
@@ -1,5 +1,5 @@
 ---
 upgrade:
   - |
-    Update a single zaqar image to zaqar-server and zaqar-wsgi
-    images.
+    Separates the single ``zaqar`` image into ``zaqar-server`` and
+    ``zaqar-wsgi`` images.
diff --git a/releasenotes/notes/upgrage-to-mariadb-10.1.20-for-redhat-family-93df8bf63da25659.yaml b/releasenotes/notes/upgrage-to-mariadb-10.1.20-for-redhat-family-93df8bf63da25659.yaml
deleted file mode 100644
index 6e3e8e004..000000000
--- a/releasenotes/notes/upgrage-to-mariadb-10.1.20-for-redhat-family-93df8bf63da25659.yaml
+++ /dev/null
@@ -1,4 +0,0 @@
----
-upgrade:
-  - |
-    Upgrade to MariaDB 10.1.20 for RHEL/CentOS/Oracle Linux.
diff --git a/releasenotes/notes/upgrage-to-mariadb-10.3.10-for-redhat-family-93df8bf63da25659.yaml b/releasenotes/notes/upgrage-to-mariadb-10.3.10-for-redhat-family-93df8bf63da25659.yaml
new file mode 100644
index 000000000..6285b8115
--- /dev/null
+++ b/releasenotes/notes/upgrage-to-mariadb-10.3.10-for-redhat-family-93df8bf63da25659.yaml
@@ -0,0 +1,5 @@
+---
+upgrade:
+  - |
+    Upgrades MariaDB to version 10.3.10 in the ``mariadb`` image for
+    RHEL/CentOS/Oracle Linux.