Add descriptions for component templates (#2155)

Author: lcawl

output/schema/schema.json

@@ -22,11 +22,13 @@ import { Names } from '@_types/common'
 import { Duration } from '@_types/Time'
 
 /**
+ * Deletes component templates.
+ * Component templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.
  * @rest_spec_name cluster.delete_component_template
  * @availability stack since=7.8.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @doc_id indices-component-template
- * @cluster_privileges manage_index_templates,manage
+ * @cluster_privileges manage_index_templates
  */
 export interface Request extends RequestBase {
   path_parts: {
@@ -36,9 +38,17 @@ export interface Request extends RequestBase {
     name: Names
   }
   query_parameters: {
-    /** @server_default 30s */
+    /**
+     * Period to wait for a connection to the master node.
+     * If no response is received before the timeout expires, the request fails and returns an error.
+     * @server_default 30s
+     */
     master_timeout?: Duration
-    /** @server_default 30s */
+    /**
+     * Period to wait for a response.
+     * If no response is received before the timeout expires, the request fails and returns an error.
+     * @server_default 30s
+     */
     timeout?: Duration
   }
 }

output/typescript/types.ts

@@ -22,27 +22,44 @@ import { Name } from '@_types/common'
 import { Duration } from '@_types/Time'
 
 /**
+ * Retrieves information about component templates.
  * @rest_spec_name cluster.get_component_template
  * @availability stack since=7.8.0 stability=stable
  * @availability serverless stability=stable visibility=public
+ * @cluster_privileges manage_index_templates
  * @doc_id indices-component-template
  */
 export interface Request extends RequestBase {
   path_parts: {
+    /**
+     * Comma-separated list of component template names used to limit the request.
+     * Wildcard (`*`) expressions are supported.
+     */
     name?: Name
   }
   query_parameters: {
-    /** @server_default false */
+    /**
+     * If `true`, returns settings in flat format.
+     * @server_default false
+     */
     flat_settings?: boolean
-    /** @server_default false */
-    local?: boolean
-    /** @server_default 30s */
-    master_timeout?: Duration
     /**
      * @server_default false
      * @availability stack since=8.8.0 stability=experimental
      * @availability serverless stability=experimental
      */
     include_defaults?: boolean
+    /**
+     * If `true`, the request retrieves information from the local node only.
+     * If `false`, information is retrieved from the master node.
+     * @server_default false
+     */
+    local?: boolean
+    /**
+     * Period to wait for a connection to the master node.
+     * If no response is received before the timeout expires, the request fails and returns an error.
+     * @server_default 30s
+     */
+    master_timeout?: Duration
   }
 }