[DOCS] Add links for longer-form examples for refresh and analyzer updates (#4525)

- link bulk request to refresh disable docs
- link analyze settings to analyzer update docs
- use markdown links in PUT settings to avoid duplicates
- add contextual verbiage pointing to linked docs

(cherry picked from commit f1305c4)

Author: leemthompo

output/openapi/elasticsearch-openapi.json

@@ -14,6 +14,7 @@ analysis-tokenizers,https://www.elastic.co/docs/reference/text-analysis/tokenize
 analysis,https://www.elastic.co/docs/manage-data/data-store/text-analysis
 analyze-repository,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-snapshot-repository-analyze
 analyzer-anatomy,https://www.elastic.co/docs/manage-data/data-store/text-analysis/anatomy-of-an-analyzer
+analyzer-update-existing,https://www.elastic.co/docs/manage-data/data-store/text-analysis/specify-an-analyzer#update-analyzers-on-existing-indices
 anthropic-messages,https://docs.anthropic.com/en/api/messages
 anthropic-models,https://docs.anthropic.com/en/docs/about-claude/models/all-models#model-names
 api-date-math-index-names,https://www.elastic.co/docs/reference/elasticsearch/rest-apis/api-conventions#api-date-math-index-names
@@ -285,50 +286,53 @@ indexing-buffer,https://www.elastic.co/docs/reference/elasticsearch/configuratio
 index-modules-merge,https://www.elastic.co/docs/reference/elasticsearch/index-settings/merge
 index-settings,https://www.elastic.co/docs/reference/elasticsearch/index-settings/
 index-templates,https://www.elastic.co/docs/manage-data/data-store/templates
-index-templates-exist,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-exists-index-template
-index-templates-put,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-put-index-template
-index-templates-v1,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-put-template
-indices-aliases,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-update-aliases
-indices-aliases-exist,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-exists-alias
-indices-analyze,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-analyze
-indices-clearcache,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-clear-cache
-indices-clone-index,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-clone
-indices-close,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-close
-indices-component-template,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-cluster-put-component-template
-indices-create-data-stream,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-create-data-stream
-indices-create-index,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-create
-indices-delete-alias,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-delete-alias
-indices-delete-index,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-delete
-indices-delete-template,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-delete-index-template
-indices-delete-template-v1,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-delete-template
-indices-disk-usage,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-disk-usage
-indices-downsample-data-stream,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-downsample
-indices-exists,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-exists
-indices-flush,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-flush
-indices-forcemerge,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-forcemerge
-indices-get-alias,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-get-alias
-indices-get-field-mapping,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-get-mapping
-indices-get-index,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-get
-indices-get-mapping,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-get-mapping
-indices-get-settings,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-get-settings
-indices-get-template,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-get-index-template
-indices-get-template-v1,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-get-template
-indices-open-close,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-open
-indices-put-mapping,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-put-mapping
-indices-recovery,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-recovery
-indices-refresh,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-refresh
-indices-reload-analyzers,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-reload-search-analyzers
-indices-resolve-cluster-api,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-resolve-cluster
-indices-resolve-index-api,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-resolve-index
-indices-rollover-index,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-rollover
-indices-segments,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-segments
-indices-shards-stores,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-shard-stores
-indices-shrink-index,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-shrink
-indices-simulate,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-simulate-index-template
-indices-simulate-template,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-simulate-template
-indices-split-index,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-split
-indices-stats,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-stats
-indices-template-exists-v1,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-exists-template
+index-templates-exist,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-exists-index-template
+index-templates-put,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-index-template
+index-templates-v1,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-template
+indices-aliases,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-update-aliases
+indices-aliases-exist,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-exists-alias
+indices-analyze,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-analyze
+indices-clearcache,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-clear-cache
+indices-clone-index,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-clone
+indices-close,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-close
+indices-component-template,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-put-component-template
+indices-create-data-stream,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-create-data-stream
+indices-create-index,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-create
+indices-delete-alias,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-delete-alias
+indices-delete-index,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-delete
+indices-delete-template,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-delete-index-template
+indices-delete-template-v1,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-delete-template
+indices-disk-usage,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-disk-usage
+indices-downsample-data-stream,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-downsample
+indices-exists,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-exists
+indices-flush,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-flush
+indices-forcemerge,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-forcemerge
+indices-get-alias,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-alias
+indices-get-data-stream-settings,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-data-stream-settings
+indices-get-field-mapping,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-mapping
+indices-get-index,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get
+indices-get-mapping,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-mapping
+indices-get-settings,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-settings
+indices-get-template,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-index-template
+indices-get-template-v1,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-template
+indices-open-close,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-open
+indices-put-data-stream-settings,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-data-stream-settings
+indices-put-mapping,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-mapping
+indices-recovery,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-recovery
+indices-refresh,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-refresh
+indices-refresh-disable,https://www.elastic.co/docs/deploy-manage/production-guidance/optimize-performance/indexing-speed#disable-refresh-interval
+indices-reload-analyzers,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-reload-search-analyzers
+indices-resolve-cluster-api,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-resolve-cluster
+indices-resolve-index-api,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-resolve-index
+indices-rollover-index,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-rollover
+indices-segments,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-segments
+indices-shards-stores,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-shard-stores
+indices-shrink-index,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-shrink
+indices-simulate,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-simulate-index-template
+indices-simulate-template,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-simulate-template
+indices-split-index,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-split
+indices-stats,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-stats
+indices-template-exists-v1,https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-exists-template
 indices-templates,https://www.elastic.co/docs/manage-data/data-store/templates
 indices-update-settings,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-indices-put-settings
 infer-trained-model,https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-infer-trained-model

output/openapi/elasticsearch-serverless-openapi.json

@@ -140,10 +140,14 @@ import { OperationContainer, UpdateAction } from './types'
  * Imagine a `_bulk?refresh=wait_for` request with three documents in it that happen to be routed to different shards in an index with five shards.
  * The request will only wait for those three shards to refresh.
  * The other two shards that make up the index do not participate in the `_bulk` request at all.
+ *
+ * You might want to disable the refresh interval temporarily to improve indexing throughput for large bulk requests.
+ * Refer to the linked documentation for step-by-step instructions using the index settings API.
  * @rest_spec_name bulk
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public
  * @doc_id docs-bulk
+ * @ext_doc_id indices-refresh-disable
  * @doc_tag document
  *
  */

output/schema/schema.json

@@ -125,6 +125,8 @@ export class IndexSettings
   max_refresh_listeners?: integer
   /**
    * Settings to define analyzers, tokenizers, token filters and character filters.
+   * Refer to the linked documentation for step-by-step examples of updating analyzers on existing indices.
+   * @ext_doc_id analyzer-update-existing
    */
   analyze?: SettingsAnalyze
   highlight?: SettingsHighlight

specification/_doc_ids/table.csv

@@ -31,7 +31,9 @@ import { IndexSettings } from '@indices/_types/IndexSettings'
  * The list of per-index settings that can be updated dynamically on live indices can be found in index settings documentation.
  * To preserve existing settings from being updated, set the `preserve_existing` parameter to `true`.
  *
- *  There are multiple valid ways to represent index settings in the request body. You can specify only the setting, for example:
+ * For performance optimization during bulk indexing, you can disable the refresh interval.
+ * Refer to [disable refresh interval](https://www.elastic.co/docs/deploy-manage/production-guidance/optimize-performance/indexing-speed#disable-refresh-interval) for an example.
+ * There are multiple valid ways to represent index settings in the request body. You can specify only the setting, for example:
  *
  * ```
  * {
@@ -75,6 +77,7 @@ import { IndexSettings } from '@indices/_types/IndexSettings'
  * This affects searches and any new data added to the stream after the rollover.
  * However, it does not affect the data stream's backing indices or their existing data.
  * To change the analyzer for existing backing indices, you must create a new data stream and reindex your data into it.
+ * Refer to [updating analyzers on existing indices](https://www.elastic.co/docs/manage-data/data-store/text-analysis/specify-an-analyzer#update-analyzers-on-existing-indices) for step-by-step examples.
  * @rest_spec_name indices.put_settings
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public