Newton release notes cleanup

Rephrasing some of the Newton release notes for clarity.
Also, fixing wrong section name in one of the release
notes.

Change-Id: Ic5371b04c369959d4ac9d769125dfe18b3d4d82f

releasenotes/notes/backup-snapshot-6e7447db930c31f6.yaml

@@ -1,3 +1,4 @@
 ---
 features:
-  - Huawei support backup snapshot optimal path
+  - Support for snapshot backup using the optimal path in
+    Huawei driver.

releasenotes/notes/datera-2.2-driver-update-28b97aa2aaf333b6.yaml

@@ -4,10 +4,9 @@ features:
   - Extended Volume-Type Support for Datera Volume Drivers
   - Naming convention change for Datera Volume Drivers
   - Volume Manage/Unmanage support for Datera Volume Drivers
-  - BoolOpt datera_debug_override_num_replicas was added for Datera Volume
-    Drivers
+  - New BoolOpt ``datera_debug_override_num_replicas`` for Datera Volume Drivers
 deprecations:
-  - datera_num_replicas IntOpt was changed to a VolumeType
-    Extra Spec -- DF:replica_count
-  - datera_acl_allow_all BoolOpt was changed to a VolumeType
-    Extra Spec -- DF:acl_allow_all
+  - IntOpt ``datera_num_replicas`` is changed to a volume type
+    extra spec option-- ``DF:replica_count``
+  - BoolOpt ``datera_acl_allow_all`` is changed to a volume type
+    extra spec option-- ``DF:acl_allow_all``

releasenotes/notes/deprecated-nas-ip-fd86a734c92f6fae.yaml

@@ -1,7 +1,5 @@
 ---
 deprecations:
-    - Deprecate the nas_ip configuration option
-      and change it to nas_host. It will be more
-      clear to use the nas_host configuration
-      option instead of the nas_ip as IP address
-      or Hostname of NAS system.
+    - Deprecated the configuration option ``nas_ip``. Use option
+      ``nas_host`` to indicate the IP address or hostname of the
+      NAS system.

releasenotes/notes/huawei-iscsi-multipath-support-a056201883909287.yaml

@@ -1,3 +1,3 @@
 ---
 upgrade:
-  - huawei iscsi multipath support
+  - Support for iSCSI multipath in Huawei driver.

releasenotes/notes/kaminario-fc-cinder-driver-8266641036281a44.yaml

@@ -1,4 +1,3 @@
 ---
 features:
-  - Add FC cinder volume driver for Kaminario K2 all-flash arrays.
-
+  - New FC Cinder volume driver for Kaminario K2 all-flash arrays.

releasenotes/notes/kaminario-iscsi-cinder-driver-c34fadf63cd253de.yaml

@@ -1,3 +1,3 @@
 ---
 features:
-  - Add iSCSI cinder volume driver for Kaminario K2 all-flash arrays.
+  - New iSCSI Cinder volume driver for Kaminario K2 all-flash arrays.

releasenotes/notes/nimble-add-force-backup-539e1e5c72f84e61.yaml

@@ -1,4 +1,3 @@
 ---
 features:
-  - Support Force backup of in-use cinder volumes
-    for Nimble Storage.
+  - Support for force backup of in-use Cinder volumes in Nimble driver.

releasenotes/notes/reject-volume_clear_size-settings-larger-than-1024MiB-30b38811da048948.yaml

@@ -1,4 +1,4 @@
 ---
 fixes:
-  - Fix 'No Space left' of dd command when users set the config item
-    volume_clear_size to larger value than a size of a volume.
+  - Fixed 'No Space left' error by dd command when users set the config option
+    ``volume_clear_size`` to a value larger than the size of a volume.

releasenotes/notes/removed-rpc-topic-config-options-21c2b3f0e64f884c.yaml

@@ -1,6 +1,6 @@
 ---
-fixes:
-  - The config options 'scheduler_topic', 'volume_topic'
-    and 'backup_topic' have been removed without a
+upgrade:
+  - The config options ``scheduler_topic``, ``volume_topic``
+    and ``backup_topic`` have been removed without a
     deprecation period as these had never worked
     correctly.

releasenotes/notes/retype-encrypted-volume-49b66d3e8e65f9a5.yaml

@@ -1,4 +1,4 @@
 ---
 features:
-  - Allow to retype volumes with different encryptions, including
+  - Support for retype volumes with different encryptions including
     changes from unencrypted types to encrypted types and vice-versa.

releasenotes/notes/vmax-iscsi-multipath-76cc09bacf4fdfbf.yaml

@@ -1,3 +1,3 @@
 ---
 features:
-  - VMAX driver iSCSI Multipathing.
+  - Support for iSCSI multipathing in EMC VMAX driver.

releasenotes/notes/vmax-qos-eb40ed35bd2f457d.yaml

@@ -1,3 +1,3 @@
 ---
 features:
-  - QoS support for the VMAX.
+  - QoS support in EMC VMAX iSCSI and FC drivers.

releasenotes/notes/vnx-new-driver-7e96934c2d3a6edc.yaml

@@ -1,16 +1,15 @@
 ---
 features:
-  - Adds VNX new Cinder driver which is based on storops.
-    storops is a library released to pypi.
+  - New Cinder driver based on storops library (available in pypi)
+    for EMC VNX.
 
 upgrade:
   - For EMC VNX backends, please upgrade to use
-    'cinder.volume.drivers.emc.vnx.driver.EMCVNXDriver'.
-    new option
-      For FC driver, adds 'storage_protocol = fc' to driver section.
-      For iSCSI driver, adds 'storage_protocol = iscsi' to driver section.
+    ``cinder.volume.drivers.emc.vnx.driver.EMCVNXDriver``. Add config option
+    ``storage_protocol = fc`` or ``storage_protocol = iscsi`` to the driver
+    section to enable the FC or iSCSI driver respectively.
 deprecations:
-  - Old VNX FC(cinder.volume.drivers.emc.emc_cli_fc.EMCCLIFCDriver)/
-    iSCSI(cinder.volume.drivers.emc.emc_cli_iscsi.EMCCLIISCSIDriver) drivers
-    were deprecated. Please refer to upgrade section for information about
-    new driver.
+  - Old VNX FC (``cinder.volume.drivers.emc.emc_cli_fc.EMCCLIFCDriver``)/
+    iSCSI (``cinder.volume.drivers.emc.emc_cli_iscsi.EMCCLIISCSIDriver``)
+    drivers are deprecated. Please refer to upgrade section for information
+    about the new driver.