Clean up release notes before a release

Change-Id: I9f1344ce247a82689878c9b5f852f0f802e8247e

releasenotes/notes/ansible-deploy-15da234580ca0c30.yaml

@@ -14,16 +14,14 @@ features:
     ``ironic-staging-drivers`` project to this ``ansible`` interface,
     operators have to consider the following differences:
 
-    - callback-less operation is not supported
+    - Callback-less operation is not supported.
-    - driver_info fields 'ansible_deploy_username' and
+    - Node's ``driver_info`` fields ``ansible_deploy_username`` and
-      'ansible_deploy_key_file' are deprecated and will be removed
+      ``ansible_deploy_key_file`` are deprecated and will be removed
-      in the Rocky release, use 'ansible_username' and 'ansible_key_file'
+      in the Rocky release. Instead, please use ``ansible_username`` and
-      respectively
+      ``ansible_key_file`` respectively.
-    - base path for playbooks can be defined in driver_info as well
+    - Base path for playbooks can be defined in the node's
-      (as 'ansible_playbooks_path' field, defaults to the value of
+      ``driver_info['ansible_playbooks_path']`` field. The default is the value
-      ``[ansible]/playbooks_path`` from ironic configuration file
+      of the ``[ansible]/playbooks_path`` option from the ironic configuration
-    - default playbooks for actions and cleaning steps file can be set in
+      file.
+    - Default playbooks for actions and cleaning steps file can be set in
       ironic configuration file as various ``[ansible]/default_*`` options.
-
-    Please read the ``ansible`` deploy interface documentation for more
-    information.

releasenotes/notes/deprecate-global-region-4dbea91de71ebf59.yaml

@@ -4,25 +4,6 @@ deprecations:
     Configuration option ``[keystone]/region_name`` is deprecated
     and will be ignored in the Rocky release.
     Instead, provide per-service ``region_name`` option in the following
-    configuration file sections:
+    configuration file sections: ``[service_catalog]`` (for bare metal API
-
+    endpoint discovery from keystone service catalog), ``[glance]``,
-    - service_catalog (for ironic API discovery from keystone service catalog)
+    ``[neutron]``, ``[cinder]``, ``[inspector]`` and ``[swift]``.
-    - glance
-    - neutron
-    - cinder
-    - inspector
-    - swift
-
-upgrade:
-  - |
-    Configuration option ``[keystone]/region_name`` is deprecated
-    and will be ignored in the Rocky release.
-    Instead, provide per-service ``region_name`` option in the following
-    configuration file sections:
-
-    - service_catalog (for ironic API discovery from keystone service catalog)
-    - glance
-    - neutron
-    - cinder
-    - inspector
-    - swift

releasenotes/notes/deprecated-inspector-opts-b19a08339712cfd7.yaml

@@ -4,14 +4,14 @@ deprecations:
     Configuration option ``[inspector]/service_url`` is deprecated
     and will be ignored in the Rocky release.
     Instead, use ``[inspector]/endpoint_override`` configuration option to set
-    specific ironic-inspector api address when automatic discovery of
+    the specific ironic-inspector API endpoint when its automatic discovery
-    inspector API endpoint from keystone catalog is not desired.
+    from the keystone catalog is not desired.
     This new option has no default value (``None``) and must be set explicitly.
 
   - |
     Relying on the value of ``[DEFAULT]/auth_strategy`` configuration option to
-    configure usage of standalone mode for inspector client is deprecated and
+    configure usage of standalone mode for ironic-inspector is deprecated and
     will be impossible the the Rocky release.
     Instead, set ``[inspector]/auth_type`` configuration option to ``none`` and
-    provide the inspector API address as ``[inspector]/endpoint_override``
+    provide the ironic-inspector inspector API address as
-    configuration option.
+    ``[inspector]/endpoint_override`` configuration option.

releasenotes/notes/deprecated-neutron-opts-2e1d9e65f00301d3.yaml

@@ -34,14 +34,14 @@ other:
 
     The functions/methods in question are:
 
-      - ``ironic.common.neutron.get_client``
+    - ``ironic.common.neutron.get_client``
-      - ``ironic.common.neutron.unbind_neutron_port``
+    - ``ironic.common.neutron.unbind_neutron_port``
-      - ``ironic.common.neutron.update_port_address``
+    - ``ironic.common.neutron.update_port_address``
-      - ``ironic.common.neutron.validate_network``
+    - ``ironic.common.neutron.validate_network``
-      - ``ironic.common.neutron.NeutronNetworkInterfaceMixin.get_cleaning_network``
+    - ``ironic.common.neutron.NeutronNetworkInterfaceMixin.get_cleaning_network``
-      - ``ironic.common.neutron.NeutronNetworkInterfaceMixin.get_provisioning_network``
+    - ``ironic.common.neutron.NeutronNetworkInterfaceMixin.get_provisioning_network``
-      - ``ironic.dhcp.neutron.NeutronDHCPApi.update_port_dhcp_opts``
+    - ``ironic.dhcp.neutron.NeutronDHCPApi.update_port_dhcp_opts``
-      - ``ironic.dhcp.none.NeutronDHCPApi.update_port_dhcp_opts``
+    - ``ironic.dhcp.none.NeutronDHCPApi.update_port_dhcp_opts``
 
     If you are using any of the above functions/methods in your out-of-tree
     ironic driver or driver interface code, you should update the code

releasenotes/notes/heartbeat_agent_version-70f4e64b19b51d87.yaml

@@ -1,8 +1,8 @@
 ---
 other:
-  - The agent heartbeat API (POST /v1/heartbeat/<node>) can now receive a new
+  - The agent heartbeat API (POST ``/v1/heartbeat/<node>``) can now receive
-    ``agent_version`` parameter. If received this will be stored in the node's
+    a new ``agent_version`` parameter. If received, this will be stored in the
-    driver_internal_info['agent_version'] field. This information will be used
+    node's ``driver_internal_info['agent_version']`` field. This information
-    by the Bare Metal service to gracefully degrade support for agent features
+    will be used by the Bare Metal service to gracefully degrade support for
-    that are requested by the Bare Metal service, ensuring that we don't
+    agent features that are requested by the Bare Metal service, ensuring that
-    request a feature that an older ramdisk doesn't support.
+    we don't request a feature that an older ramdisk doesn't support.

releasenotes/notes/irmc-additional-capabilities-4fd72ba50d05676c.yaml

@@ -1,13 +1,17 @@
 ---
 features:
   - |
-    Adds new capabilities (``server_model``, ``rom_firmware_version``, ``pci_gpu_devices``,
+    Adds new capabilities (``server_model``, ``rom_firmware_version``,
-    ``trusted_boot`` and ``irmc_firmware_version``) to the iRMC out-of-band hardware inspection
+    ``pci_gpu_devices``, ``trusted_boot`` and ``irmc_firmware_version``) to
-    for FUJITSU PRIMERGY bare metal nodes with firmware iRMC S4 and beyond.
+    the iRMC out-of-band hardware inspection for FUJITSU PRIMERGY bare metal
-    Before inspecting, if a server is powered off, it will be turned on automatically.
+    nodes with firmware iRMC S4 and newer.
-    After inspection, power status will be restored to the previous state.
+other:
+  - |
+    During the out-of-band inspection for nodes using the ``irmc`` hardware
+    type, nodes will be powered on. The original power state will be restored
+    after inspection is finished.
 upgrade:
   - |
-    Update of python-scciclient to version 0.6.0 is required by the iRMC driver to support
+    *python-scciclient* of version 0.6.0 or newer is required by the ``irmc``
-    new out-of-band inspection capabilities. If the version is not updated, the new
+    hardware type to support new out-of-band inspection capabilities. If an
-    capabilities will not be updated.
+    older version is used, the new capabilities will not be discovered.

releasenotes/notes/keystoneauth-config-1baa45a0a2dd93b4.yaml

@@ -1,22 +1,6 @@
 ---
 features:
   - |
-    Adds the ability to set keystoneauth settings in the
+    Adds the ability to set keystoneauth settings for automatic service
-    ``[glance]`` configuration section for service automatic
+    discovery in the following configuration sections: ``[glance]``,
-    discovery.
+    ``[cinder]``, ``[inspector]``, ``[swift]`` and ``[neutron]``.
-  - |
-    Adds the ability to set keystoneauth settings in the
-    ``[cinder]`` configuration section for service automatic
-    discovery.
-  - |
-    Adds the ability to set keystoneauth settings in the
-    ``[inspector]`` configuration section for service automatic
-    discovery.
-  - |
-    Adds the ability to set keystoneauth settings in the
-    ``[swift]`` configuration section for service automatic
-    discovery.
-  - |
-    Adds the ability to set keystoneauth settings in the
-    ``[neutron]`` configuration section for service automatic
-    discovery.

releasenotes/notes/wsgi-applications-5d36cf2a8885a56d.yaml

@@ -1,8 +1,9 @@
 ---
 upgrade:
-  - An Ironic API WSGI application script ``ironic-api-wsgi`` is now available.
+  - A new WSGI application script ``ironic-api-wsgi`` is now available.
-    It is auto-generated by ``pbr`` and allows to run the API service
+    It is auto-generated by ``pbr`` and provides the ability to serve
-    using WSGI server (for example Nginx and uWSGI or Apache with mod_wsgi).
+    the bare metal API using a WSGI server (for example Nginx and uWSGI or
+    Apache with mod_wsgi).
 deprecations:
   - Using ``ironic/api/app.wsgi`` script is deprecated and it will be removed
     in Rocky release.