Add summaries for root operations

specification/_global/create/CreateRequest.ts

@@ -30,6 +30,7 @@ import {
 import { Duration } from '@_types/Time'
 
 /**
+ * Index a document.
  * Adds a JSON document to the specified data stream or index and makes it searchable.
  * If the target is an index and the document already exists, the request updates the document and increments its version.
  * @rest_spec_name create

specification/_global/delete/DeleteRequest.ts

@@ -32,6 +32,7 @@ import { long } from '@_types/Numeric'
 import { Duration } from '@_types/Time'
 
 /**
+ * Delete a document.
  * Removes a JSON document from the specified index.
  * @rest_spec_name delete
  * @availability stack stability=stable

specification/_global/exists/DocumentExistsRequest.ts

@@ -29,7 +29,8 @@ import {
 import { SourceConfigParam } from '@global/search/_types/SourceFilter'
 
 /**
- * Checks if a document in an index exists.
+ * Check a document.
+ * Checks if a specified document exists.
  * @rest_spec_name exists
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public

specification/_global/exists_source/SourceExistsRequest.ts

@@ -29,6 +29,7 @@ import {
 import { SourceConfigParam } from '@global/search/_types/SourceFilter'
 
 /**
+ * Check for a document source.
  * Checks if a document's `_source` is stored.
  * @rest_spec_name exists_source
  * @availability stack since=5.4.0 stability=stable

specification/_global/explain/ExplainRequest.ts

@@ -24,7 +24,8 @@ import { SourceConfigParam } from '@global/search/_types/SourceFilter'
 import { Operator } from '@_types/query_dsl/Operator'
 
 /**
- * Returns information about why a specific document matches (or doesn’t match) a query.
+ * Explain a document match result.
+ * Returns information about why a specific document matches, or doesn’t match, a query.
  * @rest_spec_name explain
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public

specification/_global/get/GetRequest.ts

@@ -29,6 +29,8 @@ import {
 import { SourceConfigParam } from '@global/search/_types/SourceFilter'
 
 /**
+ * Get a document by its ID.
+ * Retrieves the document with the specified ID from an index.
  * @rest_spec_name get
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public

specification/_global/get_source/SourceRequest.ts

@@ -29,6 +29,8 @@ import {
 import { SourceConfigParam } from '@global/search/_types/SourceFilter'
 
 /**
+ * Get a document's source.
+ * Returns the source of a document.
  * @rest_spec_name get_source
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public

specification/_global/index/IndexRequest.ts

@@ -33,6 +33,7 @@ import { long } from '@_types/Numeric'
 import { Duration } from '@_types/Time'
 
 /**
+ * Index a document.
  * Adds a JSON document to the specified data stream or index and makes it searchable.
  * If the target is an index and the document already exists, the request updates the document and increments its version.
  * @rest_spec_name index

specification/_global/info/RootNodeInfoRequest.ts

@@ -20,6 +20,8 @@
 import { RequestBase } from '@_types/Base'
 
 /**
+ * Get cluster info.
+ * Returns basic information about the cluster.
  * @rest_spec_name info
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public

specification/_global/ping/PingRequest.ts

@@ -20,6 +20,8 @@
 import { RequestBase } from '@_types/Base'
 
 /**
+ * Ping the cluster.
+ * Returns whether the cluster is running.
  * @rest_spec_name ping
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public

specification/_global/search_mvt/SearchMvtRequest.ts

@@ -31,6 +31,8 @@ import { ZoomLevel } from './_types/ZoomLevel'
 import { TrackHits } from '@global/search/_types/hits'
 
 /**
+ * Search a vector tile.
+ * Searches a vector tile for geospatial values.
  * @rest_spec_name search_mvt
  * @availability stack since=7.15.0 stability=stable
  * @availability serverless stability=stable visibility=public

specification/_global/termvectors/TermVectorsRequest.ts

@@ -31,6 +31,8 @@ import {
 import { Filter } from './types'
 
 /**
+ * Get term vector information.
+ * Returns information and statistics about terms in the fields of a particular document.
  * @rest_spec_name termvectors
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public

specification/_global/update/UpdateRequest.ts

@@ -36,6 +36,8 @@ import { Script } from '@_types/Scripting'
 import { Duration } from '@_types/Time'
 
 /**
+ * Update a document.
+ * Updates a document by running a script or passing a partial document.
  * @rest_spec_name update
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public

specification/cluster/info/ClusterInfoRequest.ts

@@ -21,6 +21,8 @@ import { RequestBase } from '@_types/Base'
 import { ClusterInfoTargets } from '@_types/common'
 
 /**
+ * Get cluster info.
+ * Returns basic information about the cluster.
  * @rest_spec_name cluster.info
  * @availability stack since=8.9.0 stability=stable
  * @availability serverless stability=stable visibility=public

specification/cluster/reroute/ClusterRerouteRequest.ts

@@ -46,7 +46,7 @@ export interface Request extends RequestBase {
      */
     metric?: Metrics
     /**
-     * If true, then retries allocation of shards that are blocked due to too many subsequent allocation failures.
+     * If true, then retries allocation of shards that are ed due to too many subsequent allocation failures.
      * @server_default false
      */
     retry_failed?: boolean

specification/indices/add_block/IndicesAddBlockRequest.ts

@@ -22,6 +22,8 @@ import { ExpandWildcards, IndexName } from '@_types/common'
 import { Duration } from '@_types/Time'
 
 /**
+ * Add an index block.
+ * Limits the operations allowed on an index by blocking specific operation types.
  * @rest_spec_name indices.add_block
  * @availability stack since=7.9.0 stability=stable
  * @availability serverless stability=stable visibility=public

specification/indices/create/IndicesCreateRequest.ts

@@ -26,6 +26,7 @@ import { TypeMapping } from '@_types/mapping/TypeMapping'
 import { Duration } from '@_types/Time'
 
 /**
+ * Create an index.
  * Creates a new index.
  * @doc_id indices-create-index
  * @rest_spec_name indices.create

specification/indices/delete/IndicesDeleteRequest.ts

@@ -22,6 +22,7 @@ import { ExpandWildcards, Indices } from '@_types/common'
 import { Duration } from '@_types/Time'
 
 /**
+ * Delete indices.
  * Deletes one or more indices.
  * @rest_spec_name indices.delete
  * @availability stack stability=stable

specification/indices/delete_alias/IndicesDeleteAliasRequest.ts

@@ -22,6 +22,7 @@ import { Indices, Names } from '@_types/common'
 import { Duration } from '@_types/Time'
 
 /**
+ * Delete an alias.
  * Removes a data stream or index from an alias.
  * @rest_spec_name indices.delete_alias
  * @availability stack stability=stable

specification/indices/exists/IndicesExistsRequest.ts

@@ -21,7 +21,8 @@ import { RequestBase } from '@_types/Base'
 import { ExpandWildcards, Indices } from '@_types/common'
 
 /**
- * Checks if a data stream, index, or alias exists.
+ * Check indices.
+ * Checks if one or more indices, index aliases, or data streams exist.
  * @rest_spec_name indices.exists
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public

specification/indices/exists_alias/IndicesExistsAliasRequest.ts

@@ -21,6 +21,7 @@ import { RequestBase } from '@_types/Base'
 import { ExpandWildcards, Indices, Names } from '@_types/common'
 
 /**
+ * Check aliases.
  * Checks if an alias exists.
  * @rest_spec_name indices.exists_alias
  * @availability stack stability=stable

specification/indices/get/IndicesGetRequest.ts

@@ -22,6 +22,7 @@ import { ExpandWildcards, Indices } from '@_types/common'
 import { Duration } from '@_types/Time'
 
 /**
+ * Get index information.
  * Returns information about one or more indices. For data streams, the API returns information about the
  * stream’s backing indices.
  * @rest_spec_name indices.get

specification/indices/get_alias/IndicesGetAliasRequest.ts

@@ -21,6 +21,7 @@ import { RequestBase } from '@_types/Base'
 import { ExpandWildcards, Indices, Names } from '@_types/common'
 
 /**
+ * Get alias information.
  * Retrieves information for one or more aliases.
  * @rest_spec_name indices.get_alias
  * @availability stack stability=stable

specification/indices/get_settings/IndicesGetSettingsRequest.ts

@@ -22,6 +22,7 @@ import { ExpandWildcards, Indices, Names } from '@_types/common'
 import { Duration } from '@_types/Time'
 
 /**
+ * Get index settings.
  * Returns setting information for one or more indices. For data streams,
  * returns setting information for the stream’s backing indices.
  * @rest_spec_name indices.get_settings

specification/indices/put_alias/IndicesPutAliasRequest.ts

@@ -23,6 +23,7 @@ import { QueryContainer } from '@_types/query_dsl/abstractions'
 import { Duration } from '@_types/Time'
 
 /**
+ * Create or update an alias.
  * Adds a data stream or index to an alias.
  * @rest_spec_name indices.put_alias
  * @availability stack stability=stable

specification/indices/rollover/IndicesRolloverRequest.ts

@@ -27,6 +27,7 @@ import { Duration } from '@_types/Time'
 import { RolloverConditions } from './types'
 
 /**
+ * Roll over an index.
  * Creates a new index for a data stream or index alias.
  * @doc_id indices-rollover-index
  * @rest_spec_name indices.rollover

specification/indices/update_aliases/IndicesUpdateAliasesRequest.ts

@@ -22,6 +22,7 @@ import { Duration } from '@_types/Time'
 import { Action } from './types'
 
 /**
+ * Update an alias.
  * Adds a data stream or index to an alias.
  * @rest_spec_name indices.update_aliases
  * @availability stack since=1.3.0 stability=stable