Apply suggestions from code review

Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>

spec/schemas/_core.msearch.yaml

@@ -87,7 +87,7 @@ components:
               type: number
         min_score:
           description: |-
-            The minimum `_score` for matching documents. Documents with a lower `_score` than the minimum
+            The minimum `_score` for document matching. Documents with a lower `_score` than the minimum
             are not included in the search results.
           type: number
         post_filter:
@@ -133,7 +133,7 @@ components:
         stats:
           description: |-
             The statistics groups to associate with the search. Each group maintains a statistics
-            aggregation for its associated searches. You can retrieve these stats using
+            aggregation for its associated searches. You can retrieve these statistics using
             the Index Stats API.
           type: array
           items:
@@ -145,18 +145,18 @@ components:
             Default is no timeout.
           type: string
         track_scores:
-          description: When true, calculates and returns any document scores, even if the scores are not used for sorting.
+          description: When true, calculates and returns all document scores, even if the scores are not used for sorting.
           type: boolean
         track_total_hits:
           $ref: '_core.search.yaml#/components/schemas/TrackHits'
         version:
-          description: When true, returns the document version as part of a hit.
+          description: When true, returns the document version as part of the hit.
           type: boolean
         runtime_mappings:
           $ref: '_common.mapping.yaml#/components/schemas/RuntimeFields'
         seq_no_primary_term:
           description: |-
-            When true, returns sequence number and primary term of the last modification
+            When true, returns the sequence number and primary term of the last modification
             of each hit. See Optimistic concurrency control.
           type: boolean
         pit:

spec/schemas/_core.msearch_template.yaml

@@ -27,7 +27,7 @@ components:
           additionalProperties:
             type: object
         profile:
-          description: When `true`, gives a profile for the query execution.
+          description: When `true`, provides a profile for the query execution.
           type: boolean
         source:
           description: |-

spec/schemas/_core.mtermvectors.yaml

@@ -19,7 +19,7 @@ components:
         fields:
           $ref: '_common.yaml#/components/schemas/Fields'
         field_statistics:
-          description: When `true`, the response includes the document count, the sum of document frequencies, and the sum of total term frequencies.
+          description: When `true`, the response includes the document count, the sum of document frequencies, and the sum of term frequencies.
           type: boolean
         filter:
           $ref: '_core.termvectors.yaml#/components/schemas/Filter'