Add @doc_tag values

Author: lcawl

docs/overlays/elasticsearch-shared-overlays.yaml

@@ -20,6 +20,9 @@ actions:
       # A
         - name: autoscaling
           x-displayName: Autoscaling
+      # B
+        - name: analytics
+          x-displayName: Behavioral analytics
       # C 
         - name: cat
           x-displayName: Compact and aligned text (CAT)
@@ -33,8 +36,8 @@ actions:
           x-displayName: Cluster
         - name: health_report
           x-displayName: Cluster - Health
-        - name: nodes
-          x-displayName: Cluster - Nodes
+        # - name: nodes
+        #   x-displayName: Cluster - Nodes
         - name: ping
           x-displayName: Cluster - Ping
         - name: connector
@@ -53,44 +56,25 @@ actions:
             description: To get started with Connector APIs, check out the tutorial.
         - name: ccr
           x-displayName: Cross-cluster replication
-      # D  
-        - name: bulk
-          description: The bulk API performs multiple indexing or delete operations in a single API call. This reduces overhead and can greatly increase indexing speed.
-          x-displayName: Document - Bulk
-        - name: create
-          x-displayName: Document - Create
-        - name: delete
-          x-displayName: Document - Delete
-        - name: delete_by_query
-          x-displayName: Document - Delete by query
-        - name: exists
-          x-displayName: Document - Exists
-        - name: get
-          x-displayName: Document - Get
-        - name: get_source
-          x-displayName: Document - Get source
-        - name: index
-          x-displayName: Document - Index
+      # D
+        - name: data stream
+          x-displayName: Data stream
+          externalDocs:
+            description: Data stream overview 
+            url: https://www.elastic.co/guide/en/elasticsearch/reference/master/data-streams.html
+        - name: document
+          x-displayName: Document
+          externalDocs:
+            description: Reading and writing documents
+            url: https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-replication.html
         - name: mget
           x-displayName: Document - Multi get
         - name: mtermvectors
           x-displayName: Document - Multi term vectors
-        - name: reindex
-          x-displayName: Document - Reindex
         - name: delete_by_query_rethrottle
           x-displayName: Document - Rethrottle delete by query
-        - name: reindex_rethrottle
-          x-displayName: Document - Rethrottle reindex
         - name: update_by_query_rethrottle
           x-displayName: Document - Rethrottle update by query
-        - name: exists_source
-          x-displayName: Document - Source exists
-        - name: termvectors
-          x-displayName: Document - Term vectors
-        - name: update
-          x-displayName: Document - Update
-        - name: update_by_query
-          x-displayName: Document - Update by query
       # E  
         - name: enrich
           x-displayName: Enrich
@@ -157,10 +141,10 @@ actions:
             url: https://www.elastic.co/guide/en/logstash/current/logstash-centralized-pipeline-management.html
             description: Centralized pipeline management
       # M
-        - name: migration
-          x-displayName: Migration
         - name: ml
           x-displayName: Machine learning
+        - name: migration
+          x-displayName: Migration
         - name: monitoring
           x-displayName: Monitoring
       # N
@@ -182,56 +166,25 @@ actions:
       # R
         - name: rollup
           x-displayName: Rollup
-      # S  
-        - name: put_script
-          x-displayName: Script - Create or update
+      # S
+        - name: script
+          x-displayName: Script
         - name: delete_script
           x-displayName: Script - Delete
-        - name: get_script
-          x-displayName: Script - Get
         - name: get_script_context
           x-displayName: Script - Get contexts
         - name: get_script_languages
           x-displayName: Script - Get languages
-        - name: scripts_painless_execute
-          x-displayName: Script - Run painless
         - name: search
           x-displayName: Search
-        - name: async_search
-          description: The async search API enables you to asynchronously run a search request, monitor its progress, and retrieve partial results as they become available.
-          x-displayName: Search - Async
-        - name: clear_scroll
-          x-displayName: Search - Clear scroll
-        - name: close_point_in_time
-          x-displayName: Search - Close point in time
-        - name: count
-          x-displayName: Search - Count
-        - name: explain
-          x-displayName: Search - Explain
-        - name: field_caps
-          x-displayName: Search - Field capabilities
         - name: knn_search
           x-displayName: Search - kNN
         - name: msearch
           x-displayName: Search - Multi search
-        - name: msearch_template
-          x-displayName: Search - Multi search template
-        - name: open_point_in_time
-          x-displayName:  Search - Open point in time
-        - name: rank_eval
-          x-displayName: Search - Ranking evaluation
-        - name: render_search_template
-          x-displayName: Search - Render search template
         - name: scroll
           x-displayName: Search - Scroll
-        - name: search_shards
-          x-displayName: Search - Shards
-        - name: search_template
-          x-displayName: Search - Search template
         - name: terms_enum
           x-displayName: Search - Terms enum
-        - name: search_mvt
-          x-displayName: Search - Vector tile search
         - name: search_application
           x-displayName: Search application
         - name: searchable_snapshots

specification/_global/bulk/BulkRequest.ts

@@ -37,6 +37,7 @@ import { OperationContainer, UpdateAction } from './types'
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
  * @doc_id docs-bulk
+ * @doc_tag document
  *
  */
 export interface Request<TDocument, TPartialDocument> extends RequestBase {

specification/_global/clear_scroll/ClearScrollRequest.ts

@@ -26,6 +26,7 @@ import { ScrollIds } from '@_types/common'
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
  * @doc_id clear-scroll-api
+ * @doc_tag search
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/close_point_in_time/ClosePointInTimeRequest.ts

@@ -26,6 +26,7 @@ import { Id } from '@_types/common'
  * @availability stack since=7.10.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @doc_id point-in-time-api
+ * @doc_tag search
  */
 export interface Request extends RequestBase {
   body: {

specification/_global/count/CountRequest.ts

@@ -27,6 +27,7 @@ import { Operator } from '@_types/query_dsl/Operator'
  * @rest_spec_name count
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag search
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/create/CreateRequest.ts

@@ -36,7 +36,7 @@ import { Duration } from '@_types/Time'
  * @rest_spec_name create
  * @availability stack since=5.0.0 stability=stable
  * @availability serverless stability=stable visibility=public
- *
+ * @doc_tag document
  */
 export interface Request<TDocument> extends RequestBase {
   path_parts: {

specification/_global/delete/DeleteRequest.ts

@@ -37,6 +37,7 @@ import { Duration } from '@_types/Time'
  * @rest_spec_name delete
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag document
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/delete_by_query/DeleteByQueryRequest.ts

@@ -39,6 +39,7 @@ import { Duration } from '@_types/Time'
  * @rest_spec_name delete_by_query
  * @availability stack since=5.0.0 stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag document
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/delete_script/DeleteScriptRequest.ts

@@ -27,6 +27,7 @@ import { Duration } from '@_types/Time'
  * @rest_spec_name delete_script
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag script
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/exists/DocumentExistsRequest.ts

@@ -34,6 +34,7 @@ import {
  * @rest_spec_name exists
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag document
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/exists_source/SourceExistsRequest.ts

@@ -34,6 +34,7 @@ import {
  * @rest_spec_name exists_source
  * @availability stack since=5.4.0 stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag document
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/explain/ExplainRequest.ts

@@ -29,6 +29,7 @@ import { Operator } from '@_types/query_dsl/Operator'
  * @rest_spec_name explain
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag search
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/field_caps/FieldCapabilitiesRequest.ts

@@ -30,6 +30,7 @@ import { QueryContainer } from '@_types/query_dsl/abstractions'
  * @availability stack since=5.4.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @index_privileges view_index_metadata,read,manage
+ * @doc_tag search
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/get/GetRequest.ts

@@ -34,6 +34,7 @@ import {
  * @rest_spec_name get
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag document
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/get_script/GetScriptRequest.ts

@@ -27,6 +27,7 @@ import { Duration } from '@_types/Time'
  * @rest_spec_name get_script
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag script
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/get_source/SourceRequest.ts

@@ -34,6 +34,7 @@ import {
  * @rest_spec_name get_source
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag document
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/index/IndexRequest.ts

@@ -39,6 +39,7 @@ import { Duration } from '@_types/Time'
  * @rest_spec_name index
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag document
  */
 export interface Request<TDocument> extends RequestBase {
   path_parts: {

specification/_global/knn_search/KnnSearchRequest.ts

@@ -27,6 +27,7 @@ import { Query } from './_types/Knn'
  * @rest_spec_name knn_search
  * @availability stack since=8.0.0 stability=experimental
  * @deprecated 8.4.0
+ * @doc_tag search
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/msearch_template/MultiSearchTemplateRequest.ts

@@ -28,6 +28,7 @@ import { RequestItem } from './types'
  * @availability stack since=5.0.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @index_privileges read
+ * @doc_tag search
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/open_point_in_time/OpenPointInTimeRequest.ts

@@ -34,6 +34,7 @@ import { Duration } from '@_types/Time'
  * @availability serverless stability=stable visibility=public
  * @doc_id point-in-time-api
  * @index_privileges read
+ * @doc_tag search
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/put_script/PutScriptRequest.ts

@@ -28,6 +28,7 @@ import { Duration } from '@_types/Time'
  * @rest_spec_name put_script
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag script
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/rank_eval/RankEvalRequest.ts

@@ -27,6 +27,7 @@ import { RankEvalMetric, RankEvalRequestItem } from './types'
  * @availability stack since=6.2.0 stability=stable
  * @availability serverless stability=stable visibility=public
  * @index_privileges read
+ * @doc_tag search
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/reindex/ReindexRequest.ts

@@ -30,6 +30,7 @@ import { Destination, Source } from './types'
  * @rest_spec_name reindex
  * @availability stack since=2.3.0 stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag document
  */
 export interface Request extends RequestBase {
   query_parameters: {

specification/_global/reindex_rethrottle/ReindexRethrottleRequest.ts

@@ -26,6 +26,7 @@ import { float } from '@_types/Numeric'
  * @rest_spec_name reindex_rethrottle
  * @availability stack since=2.4.0 stability=stable
  * @availability serverless stability=stable visibility=private
+ * @doc_tag document
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/render_search_template/RenderSearchTemplateRequest.ts

@@ -27,6 +27,7 @@ import { Id } from '@_types/common'
  * @rest_spec_name render_search_template
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag search
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/scripts_painless_execute/ExecutePainlessScriptRequest.ts

@@ -27,6 +27,7 @@ import { PainlessContextSetup } from './types'
  * @rest_spec_name scripts_painless_execute
  * @availability stack since=6.3.0 stability=experimental
  * @availability serverless stability=experimental visibility=public
+ * @doc_tag script
  */
 export interface Request extends RequestBase {
   body: {

specification/_global/search_mvt/SearchMvtRequest.ts

@@ -36,6 +36,8 @@ import { ZoomLevel } from './_types/ZoomLevel'
  * @rest_spec_name search_mvt
  * @availability stack since=7.15.0 stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag search
+ * 
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/search_shards/SearchShardsRequest.ts

@@ -23,6 +23,7 @@ import { ExpandWildcards, Indices, Routing } from '@_types/common'
 /**
  * @rest_spec_name search_shards
  * @availability stack stability=stable
+ * @doc_tag search
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/search_template/SearchTemplateRequest.ts

@@ -34,6 +34,7 @@ import { Duration } from '@_types/Time'
  * @rest_spec_name search_template
  * @availability stack since=2.0.0 stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag search
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/termvectors/TermVectorsRequest.ts

@@ -36,6 +36,7 @@ import { Filter } from './types'
  * @rest_spec_name termvectors
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag document
  */
 export interface Request<TDocument> extends RequestBase {
   path_parts: {

specification/_global/update/UpdateRequest.ts

@@ -41,6 +41,7 @@ import { Duration } from '@_types/Time'
  * @rest_spec_name update
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag document
  */
 export interface Request<TDocument, TPartialDocument> extends RequestBase {
   path_parts: {

specification/_global/update_by_query/UpdateByQueryRequest.ts

@@ -41,6 +41,7 @@ import { Duration } from '@_types/Time'
  * @rest_spec_name update_by_query
  * @availability stack since=2.4.0 stability=stable
  * @availability serverless stability=stable visibility=public
+ * @doc_tag document
  */
 export interface Request extends RequestBase {
   path_parts: {