Apply suggestions from code review

Apply suggested improvements from code review

Co-authored-by: Lisa Cawley <[email protected]>
Co-authored-by: Laura Trotta <[email protected]>

Author: 3 people

specification/cluster/allocation_explain/ClusterAllocationExplainRequest.ts

@@ -25,7 +25,7 @@ import { Duration } from '@_types/Time'
 /**
  * Explain the shard allocations.
  * Get explanations for shard allocations in the cluster.
- * This API accepts the current_node, index, primary and shard parameters via the request body, or via query parameters, but not via both at the same time.
+ * This API accepts the current_node, index, primary and shard parameters in the request body or in query parameters, but not in both at the same time.
  * For unassigned shards, it provides an explanation for why the shard is unassigned.
  * For assigned shards, it provides an explanation for why the shard is remaining on its current node and has not moved or rebalanced to another node.
  * This API can be very useful when attempting to diagnose why a shard is unassigned or why a shard continues to remain on its current node when you might expect otherwise.

specification/cluster/allocation_explain/examples/request/ClusterAllocationExplainRequestExample2.yaml

@@ -1,5 +1,5 @@
 summary: Query Parameters
-method_request: GET _cluster/allocation/explain
+method_request: GET _cluster/allocation/explain?index=my-index-000001&shard=0&primary=false&current_node=my-node
 description: >
   Run `GET _cluster/allocation/explain?index="my-index-000001"&shard=0&primary=false&current_node="my-node` to get an explanation for a shard's current allocation. No parameters are required in the request body
 # type: request