fix typos and adjust overview

Author: charlotte-hoblik

deploy-manage/autoscaling.md

@@ -17,17 +17,19 @@ applies_to:
 {{cloud-only}}
 ::::
 
-The autoscaling feature enables an operator to configure tiers of nodes that self-monitor whether or not they need to scale based on an operator-defined policy. Then, via the autoscaling API, an Elasticsearch cluster can report whether or not it needs additional resources to meet the policy. For example, an operator could define a policy that a warm tier should scale on available disk space. Elasticsearch would monitor and forecast the available disk space in the warm tier, and if the forecast is such that the cluster will soon not be able to allocate existing and future shard copies due to disk space, then the autoscaling API would report that the cluster needs to scale due to disk space. It remains the responsibility of the operator to add the additional resources that the cluster signals it requires.
+The autoscaling feature allows an operator to create tiers of nodes. These nodes monitor themselves to decide if they need to scale, based on an operator-defined policy. An Elasticsearch cluster can use the autoscaling API to report if it needs more resources to meet the policy. For example, an operator could define a policy that a warm tier should scale on available disk space. Elasticsearch monitors disk space in the warm tier. If it predicts low disk space for current and future shard copies, the autoscaling API will report that the cluster needs to scale. It remains the responsibility of the operator to add the additional resources that the cluster signals it requires.
 
-A policy is composed of a list of roles and a list of deciders. Nodes matching the roles are governed by the policy. The deciders provide independent estimates of the capacity required. See [Autoscaling deciders](../deploy-manage/autoscaling/autoscaling-deciders.md) for more information on the deciders available.
+A policy is composed of a list of roles and a list of deciders. The policy governs the nodes matching the roles. The deciders provide independent estimates of the capacity required. See [Autoscaling deciders](../deploy-manage/autoscaling/autoscaling-deciders.md) for details on available deciders.
 
-Autoscaling supports the scale-up and scale-down of dedicated {{ml}} nodes. Autoscaling also supports the scale-up of data nodes based on storage.
+Autoscaling supports:
+* Scaling machine learning nodes up and down.
+* Scaling data nodes up based on storage.
 
 ::::{note} 
 Autoscaling is not supported on Debian 8.
 ::::
 
-Autoscaling helps you to more easily manage your deployments by adjusting their available resources automatically, and currently supports scaling for both data and machine learning nodes, or machine learning nodes only. Check the following sections to learn more:
+To learn more about configuring and managing autoscaling, check the following sections:
 
 * [Overview](#ec-autoscaling-intro)
 * [When does autoscaling occur?](#ec-autoscaling-factors)

deploy-manage/autoscaling/ec-hosted-autoscaling-api-example.md

@@ -31,7 +31,6 @@ Note the following requirements when you run this API request:
 
 
 $$$ec-autoscaling-api-example-requirements-table$$$
-+
 
 |     |     |     |     |
 | --- | --- | --- | --- |
@@ -42,15 +41,13 @@ $$$ec-autoscaling-api-example-requirements-table$$$
 | Kibana | ✓ | ✕ | ✕ |
 | APM | ✓ | ✕ | ✕ |
 
-+
+* ✓ = Include the property.
 
-+ ✓ = Include the property.
+* ✕ = Do not include the property.
 
-+ ✕ = Do not include the property.
+* These rules match the behavior of the {{ecloud}} Console.
 
-+ These rules match the behavior of the {{ecloud}} Console.
-
-+ * The `elasticsearch` object must contain the property `"autoscaling_enabled": true`.
+* `*` The `elasticsearch` object must contain the property `"autoscaling_enabled": true`.
 
 
 ## API request example [ec_api_request_example] 

deploy-manage/autoscaling/ece-autoscaling-api-example.md

@@ -33,7 +33,6 @@ Note the following requirements when you run this API request:
 
 
 $$$ece-autoscaling-api-example-requirements-table$$$
-+
 
 |     |     |     |     |
 | --- | --- | --- | --- |
@@ -44,15 +43,13 @@ $$$ece-autoscaling-api-example-requirements-table$$$
 | Kibana | ✓ | ✕ | ✕ |
 | APM | ✓ | ✕ | ✕ |
 
-+
+* ✓ = Include the property.
 
-+ ✓ = Include the property.
+* ✕ = Do not include the property.
 
-+ ✕ = Do not include the property.
+* These rules match the behavior of the Elastic Cloud Enterprise user console.
 
-+ These rules match the behavior of the Elastic Cloud Enterprise user console.
-
-+ * The `elasticsearch` object must contain the property `"autoscaling_enabled": true`.
+* `*` The `elasticsearch` object must contain the property `"autoscaling_enabled": true`.
 
 
 ## API request example [ece_api_request_example]