# Reverted generated diff

Signed-off-by: Theo Truong <theotr@amazon.com>

lib/opensearch/api/actions/asynchronous_search/delete.rb

@@ -13,7 +13,7 @@ module OpenSearch
   module API
     module AsynchronousSearch
       module Actions
-        # Deletes any responses from an asynchronous search.
+        # Delete asynchronous search.
         #
         # @option args [String] :id *Required*
         # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request

lib/opensearch/api/actions/asynchronous_search/get.rb

@@ -13,7 +13,7 @@ module OpenSearch
   module API
     module AsynchronousSearch
       module Actions
-        # Gets partial responses from an asynchronous search.
+        # Get partial responses from asynchronous search.
         #
         # @option args [String] :id *Required*
         def get(args = {})

lib/opensearch/api/actions/asynchronous_search/search.rb

@@ -13,12 +13,12 @@ module OpenSearch
   module API
     module AsynchronousSearch
       module Actions
-        # Performs an asynchronous search.
+        # Perform an asynchronous search.
         #
         # @option args [String] :index The name of the index to be searched. Can be an individual name, a comma-separated list of indexes, or a wildcard expression of index names.
-        # @option args [String] :keep_alive The amount of time that the result is saved in the cluster. For example, `2d` means that the results are stored in the cluster for 48 hours.  The saved search results are deleted after this period or if the search is canceled. Note that this includes the query execution time.  If the query exceeds this amount of time, the process cancels this query automatically.
-        # @option args [Boolean] :keep_on_completion Whether to save the results in the cluster after the search is complete. You can examine the stored results at a later time.
-        # @option args [String] :wait_for_completion_timeout The amount of time to wait for the results. You can poll the remaining results based on an ID. The maximum value is 300 seconds. Default is `1s`.
+        # @option args [String] :keep_alive The amount of time that the result is saved in the cluster. For example, `2d` means that the results are stored in the cluster for 48 hours. The saved search results are deleted after this period or if the search is canceled. Note that this includes the query execution time. If the query overruns this time, the process cancels this query automatically.
+        # @option args [Boolean] :keep_on_completion Whether you want to save the results in the cluster after the search is complete.
+        # @option args [String] :wait_for_completion_timeout The amount of time that you plan to wait for the results. You can poll the remaining results based on an ID. The maximum value is `300s`. Default is `1s`.
         # @option args [Hash] :body The search definition using the Query DSL.
         def search(args = {})
           args = Utils.clone_and_normalize_arguments(args)

lib/opensearch/api/actions/asynchronous_search/stats.rb

@@ -13,7 +13,7 @@ module OpenSearch
   module API
     module AsynchronousSearch
       module Actions
-        # Monitors any asynchronous searches that are `running`, `completed`, or `persisted`.
+        # Monitoring of asynchronous searches that are running, completed, and/or persisted.
         #
         def stats(args = {})
           args = Utils.clone_and_normalize_arguments(args)

lib/opensearch/api/actions/bulk_stream.rb

@@ -23,7 +23,7 @@ module Actions
         # @option args [String] :pipeline ID of the pipeline to use to preprocess incoming documents. If the index has a default ingest pipeline specified, then setting the value to `_none` disables the default ingest pipeline for this request. If a final pipeline is configured it will always run, regardless of the value of this parameter.
         # @option args [Boolean, String] :refresh If `true`, OpenSearch refreshes the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` do nothing with refreshes. Valid values: `true`, `false`, `wait_for`.
         # @option args [Boolean] :require_alias If `true`, the request's actions must target an index alias.
-        # @option args [Hash] :routing Custom value used to route operations to a specific shard.
+        # @option args [Enumerable<String>, String] :routing Custom value used to route operations to a specific shard.
         # @option args [String] :timeout Period each action waits for the following operations: automatic index creation, dynamic mapping updates, waiting for active shards.
         # @option args [String] :type Default document type for items which don't provide one.
         # @option args [Integer, String] :wait_for_active_shards The number of shard copies that must be active before proceeding with the operation. Set to all or any positive integer up to the total number of shards in the index (`number_of_replicas+1`).

lib/opensearch/api/actions/cat/aliases.rb

@@ -13,15 +13,15 @@ module OpenSearch
   module API
     module Cat
       module Actions
-        # Shows information about aliases currently configured to indexes, including filter and routing information.
+        # Shows information about currently configured aliases to indexes including filter and routing info.
         #
-        # @option args [Enumerable<String>, String] :expand_wildcards Specifies the type of index that wildcard expressions can match. Supports comma-separated values.
-        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
-        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
-        # @option args [Boolean] :help Returns help information.
-        # @option args [Boolean] :local Whether to return information from the local node only instead of from the cluster manager node.
-        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
+        # @option args [Enumerable<String>, String] :expand_wildcards Whether to expand wildcard expression to concrete indexes that are open, closed or both.
+        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
+        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
+        # @option args [Boolean] :help Return help information.
+        # @option args [Boolean] :local Return local information, do not retrieve the state from cluster-manager node.
+        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Verbose mode. Display column headers.
         # @option args [Enumerable<String>, String] :name A comma-separated list of aliases to retrieve. Supports wildcards (`*`).  To retrieve all aliases, omit this parameter or use `*` or `_all`.
         def aliases(args = {})
           args = Utils.clone_and_normalize_arguments(args)

lib/opensearch/api/actions/cat/all_pit_segments.rb

@@ -13,14 +13,14 @@ module OpenSearch
   module API
     module Cat
       module Actions
-        # Lists all active CAT point-in-time segments.
+        # Lists all active point-in-time segments.
         #
-        # @option args [String] :bytes The units used to display byte values.
-        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
-        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
-        # @option args [Boolean] :help Returns help information.
-        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
+        # @option args [String] :bytes The unit in which to display byte values.
+        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
+        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
+        # @option args [Boolean] :help Return help information.
+        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Verbose mode. Display column headers.
         def all_pit_segments(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           headers = args.delete('headers') || {}

lib/opensearch/api/actions/cat/allocation.rb

@@ -15,16 +15,16 @@ module Cat
       module Actions
         # Provides a snapshot of how many shards are allocated to each data node and how much disk space they are using.
         #
-        # @option args [String] :bytes The units used to display byte values.
-        # @option args [String] :cluster_manager_timeout A timeout for connection to the cluster manager node.
-        # @option args [String] :format A short version of the HTTP `Accept` header, such as `json` or `yaml`.
-        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
-        # @option args [Boolean] :help Returns help information.
-        # @option args [Boolean] :local Returns local information but does not retrieve the state from cluster-manager node.
-        # @option args [String] :master_timeout DEPRECATED A timeout for connection to the cluster manager node.
-        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
-        # @option args [Enumerable<String>, String] :node_id A comma-separated list of node IDs or names used to limit the returned information.
+        # @option args [String] :bytes The unit used to display byte values.
+        # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
+        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
+        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
+        # @option args [Boolean] :help Return help information.
+        # @option args [Boolean] :local Return local information, do not retrieve the state from cluster-manager node.
+        # @option args [String] :master_timeout DEPRECATED Operation timeout for connection to cluster-manager node.
+        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [Enumerable<String>, String] :node_id Comma-separated list of node identifiers or names used to limit the returned information.
         def allocation(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           _node_id = args.delete('node_id')

lib/opensearch/api/actions/cat/cluster_manager.rb

@@ -15,14 +15,14 @@ module Cat
       module Actions
         # Returns information about the cluster-manager node.
         #
-        # @option args [String] :cluster_manager_timeout A timeout for connection to the cluster manager node.
-        # @option args [String] :format A short version of the HTTP `Accept` header, such as `json` or `yaml`.
-        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
-        # @option args [Boolean] :help Returns help information.
-        # @option args [Boolean] :local Returns local information but does not retrieve the state from the cluster manager node.
-        # @option args [String] :master_timeout DEPRECATED A timeout for connection to the cluster manager node.
-        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
+        # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
+        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
+        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
+        # @option args [Boolean] :help Return help information.
+        # @option args [Boolean] :local Return local information, do not retrieve the state from cluster-manager node.
+        # @option args [String] :master_timeout DEPRECATED Operation timeout for connection to cluster-manager node.
+        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Verbose mode. Display column headers.
         def cluster_manager(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           headers = args.delete('headers') || {}

lib/opensearch/api/actions/cat/count.rb

@@ -13,13 +13,13 @@ module OpenSearch
   module API
     module Cat
       module Actions
-        # Provides quick access to the document count of the entire cluster or of an individual index.
+        # Provides quick access to the document count of the entire cluster, or individual indexes.
         #
-        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
-        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
-        # @option args [Boolean] :help Returns help information.
-        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
+        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
+        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
+        # @option args [Boolean] :help Return help information.
+        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Verbose mode. Display column headers.
         # @option args [Enumerable<String>, String] :index Comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`.
         def count(args = {})
           args = Utils.clone_and_normalize_arguments(args)

lib/opensearch/api/actions/cat/fielddata.rb

@@ -15,13 +15,13 @@ module Cat
       module Actions
         # Shows how much heap memory is currently being used by field data on every data node in the cluster.
         #
-        # @option args [String] :bytes The units used to display byte values.
-        # @option args [Enumerable<String>, String] :fields A comma-separated list of fields used to limit the amount of returned information.
-        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
-        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
-        # @option args [Boolean] :help Returns help information.
-        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
+        # @option args [String] :bytes The unit used to display byte values.
+        # @option args [Enumerable<String>, String] :fields Comma-separated list of fields used to limit returned information.
+        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
+        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
+        # @option args [Boolean] :help Return help information.
+        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Verbose mode. Display column headers.
         def fielddata(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           _fields = args.delete('fields')

lib/opensearch/api/actions/cat/health.rb

@@ -15,13 +15,13 @@ module Cat
       module Actions
         # Returns a concise representation of the cluster health.
         #
-        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
-        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
-        # @option args [Boolean] :help Returns help information.
-        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
+        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
+        # @option args [Boolean] :help Return help information.
+        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
         # @option args [String] :time The unit used to display time values.
-        # @option args [Boolean] :ts (default: true) When `true`, returns `HH:MM:SS` and Unix epoch timestamps.
-        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
+        # @option args [Boolean] :ts (default: true) If `true`, returns `HH:MM:SS` and Unix epoch timestamps.
+        # @option args [Boolean] :v Verbose mode. Display column headers.
         def health(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           headers = args.delete('headers') || {}