Some wording tweaks

Author: aetter

docs/upgrade/1-10-1.md

@@ -1,22 +1,25 @@
 ---
 layout: default
-title: Upgrade to 1.10.1 (Kibana)
+title: Upgrade to 1.10.1
 parent: Upgrade
-nav_order: 3
+nav_order: 2
 ---
 
 # Upgrade to 1.10.1 (Kibana)
 
-Open Distro for Elasticsearch 1.10.1 includes a breaking change as Security Kibana plugin was re-implemented with Kibana’s new plugin platform
+Open Distro for Elasticsearch 1.10.1 includes a breaking change for the Kibana security plugin, which now uses the new Kibana plugin platform.
 
-## Security Kibana Plugin
 
-If you:
-* Upgrade Kibana from any of the previous versions to 1.10.1
-* Use `Security Kibana Plugin` v1.10.1.1 or newer
-* Use **unsecured HTTP** as the communication protocol
+## Kibana security plugin
 
-Then you need to add this line into your kibana.yml configuration file and restart Kibana
-```bash
+You must make a manual configuration change if your Kibana install meets these conditions:
+
+* You upgraded Kibana from any of the previous versions to 1.10.1.
+* You use the Kibana security plugin version 1.10.1.1 or newer.
+* You use unsecured HTTP for the communication protocol.
+
+Add this line to `kibana.yml`, and restart Kibana:
+
+```yml
 opendistro_security.cookie.secure: false
 ```

docs/upgrade/1-8-0.md

@@ -2,7 +2,7 @@
 layout: default
 title: Upgrade to 1.8.0
 parent: Upgrade
-nav_order: 2
+nav_order: 3
 ---
 
 # Upgrade to 1.8.0