Add example for root API

Author: lcawl

output/openapi/elasticsearch-openapi.json

@@ -8,6 +8,7 @@ analysis-tokenizers,https://www.elastic.co/guide/en/elasticsearch/reference/{bra
 analysis,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/analysis.html
 analyzer-anatomy,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/analyzer-anatomy.html
 api-date-math-index-names,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/api-conventions.html#api-date-math-index-names
+api-root,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/rest-api-root.html
 append-processor,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/append-processor.html
 async-search,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/async-search.html
 attachment,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/attachment.html

output/openapi/elasticsearch-serverless-openapi.json

@@ -21,9 +21,11 @@ import { RequestBase } from '@_types/Base'
 
 /**
  * Get cluster info.
- * Returns basic information about the cluster.
+ * Get basic build, version, and cluster information.
  * @rest_spec_name info
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @cluster_privileges monitor
+ * @doc_id api-root
  */
 export interface Request extends RequestBase {}

output/schema/schema.json

@@ -22,10 +22,19 @@ import { Name, Uuid } from '@_types/common'
 
 export class Response {
   body: {
+    /**
+     * The responding cluster's name.
+     */
     cluster_name: Name
     cluster_uuid: Uuid
+    /**
+     * The responding node's name.
+     */
     name: Name
     tagline: string
+    /**
+     * The running version of Elasticsearch.
+     */
     version: ElasticsearchVersionInfo
   }
 }

specification/_doc_ids/table.csv

@@ -0,0 +1,19 @@
+# summary: ''
+description: A successful response from `GET /`s.
+# type: response
+# response_code: 200
+value:
+  name: instance-0000000000
+  cluster_name: my_test_cluster
+  cluster_uuid: 5QaxoN0pRZuOmWSxstBBwQ
+  version:
+    build_date: '2024-02-01T13:07:13.727175297Z'
+    minimum_wire_compatibility_version: 7.17.0
+    build_hash: 6185ba65d27469afabc9bc951cded6c17c21e3f3
+    number: 8.12.1
+    lucene_version: 9.9.2
+    minimum_index_compatibility_version: 7.0.0
+    build_flavor: default
+    build_snapshot: false
+    build_type: docker
+  tagline: 'You Know, for Search'

specification/_global/info/RootNodeInfoRequest.ts

@@ -52,14 +52,43 @@ export class AcknowledgedResponseBase {
 export class DynamicResponseBase {}
 
 export class ElasticsearchVersionInfo {
+  /**
+   * The Elasticsearch Git commit's date.
+   */
   build_date: DateTime
+  /**
+   * The build flavor. For example, `default`.
+   */
   build_flavor: string
+  /**
+   * The Elasticsearch Git commit's SHA hash.
+   */
   build_hash: string
+  /**
+   * Indicates whether the Elasticsearch build was a snapshot.
+   */
   build_snapshot: boolean
+  /**
+   * The build type that corresponds to how Elasticsearch was installed.
+   * For example, `docker`, `rpm`, or `tar`.
+   */
   build_type: string
+  /**
+   * The version number of Elasticsearch's underlying Lucene software.
+   */
   lucene_version: VersionString
+  /**
+   * The minimum index version with which the responding node can read from disk.
+   */
   minimum_index_compatibility_version: VersionString
+  /**
+   * The minimum node version with which the responding node can communicate.
+   * Also the minimum version from which you can perform a rolling upgrade.
+   */
   minimum_wire_compatibility_version: VersionString
+  /**
+   * The Elasticsearch version number.
+   */
   number: string
 }