Merge branch 'main' into es8-breakingchange

Author: jugal-chauhan

.github/vale/styles/OpenSearch/HeadingCapitalization.yml

@@ -10,4 +10,5 @@ indicators:
 exceptions:
   - k    # ignores lowercase k-NN
   - '[A-Z]{2,}' # ignores all acronyms
-  - '([A-Z][a-z0-9]+){2,}' # ignores all camel case words
+  - '([A-Z][a-z0-9]+){2,}' # ignores all camel case words
+  - '\b\w+\s+API'

_about/version-history.md

@@ -11,6 +11,7 @@ OpenSearch version | Release highlights | Release date
 :--- | :--- | :--- 
 [3.1.0](https://github.com/opensearch-project/opensearch-build/blob/main/release-notes/opensearch-release-notes-3.1.0.md) | Makes GPU acceleration for vector index builds generally available. Introduces memory-optimized search for Faiss indexes using Lucene HNSW, semantic field type for streamlined semantic search, and Search Relevance Workbench for search quality optimization. Makes star-tree indexes generally available with support for comprehensive query types. Enhances observability with ML Commons metrics integration, custom index support for OpenTelemetry data, and new PPL commands for JSON manipulation. Improves agent management with Update Agent API and persistent MCP tools. Includes security enhancements with immutable user objects and new resource sharing framework. For a full list of release highlights, see the Release Notes. | 24 June 2025
 [3.0.0](https://github.com/opensearch-project/opensearch-build/blob/main/release-notes/opensearch-release-notes-3.0.0.md) | Upgrades to Lucene 10 for improved indexing and vector search. Adds experimental gRPC support and pull-based ingestion from Kafka and Kinesis. Introduces GPU acceleration for vector operations and semantic sentence highlighting. Improves range query performance and hybrid search with z-score normalization. Adds plan-execute-reflect agents and native MCP protocol support for agentic workflows. Enhances security with a new Java agent replacing the Security Manager. Includes PPL query improvements with lookup, join, and subsearch commands. For a full list of release highlights, see the Release Notes. | 06 May 2025
+[2.19.3](https://github.com/opensearch-project/opensearch-build/blob/main/release-notes/opensearch-release-notes-2.19.3.md) | Improves Flow Framework with enhanced memory handling and workflow step processing. Fixes several Query Insights and Query Insights Dashboards issues. Implements security updates across multiple components. Updates infrastructure components and documentation across multiple plugins. | 22 July 2025 
 [2.19.2](https://github.com/opensearch-project/opensearch-build/blob/main/release-notes/opensearch-release-notes-2.19.2.md) |  Improves query insights with better index handling, a new verbose API parameter, and a default index template. Fixes bugs across Query Insights, Observability, Flow Framework, and Dashboards. Includes multiple CVE fixes, test enhancements, and a new PGP key for artifact verification. For a full list of release highlights, see the Release Notes. | 29 April 2025
 [2.19.1](https://github.com/opensearch-project/opensearch-build/blob/main/release-notes/opensearch-release-notes-2.19.1.md) |  Adds execution hint for cardinality aggregator. Includes bug fixes for ML Commons, Query Insights Dashboards, and Remote Metadata SDK. Contains maintenance updates for several components. For a full list of release highlights, see the Release Notes. | 27 February 2025
 [2.19.0](https://github.com/opensearch-project/opensearch-build/blob/main/release-notes/opensearch-release-notes-2.19.0.md) | Adds workload management, additional query insights, and template queries. Introduces a query insights page to OpenSearch Dashboards. Includes improvements and bug fixes to snapshots, search statistics, star-tree search, and index management. For a full list of release highlights, see the Release Notes. | 11 February 2025

_aggregations/bucket/auto-interval-date-histogram.md

@@ -2,7 +2,6 @@
 layout: default
 title: Auto-interval date histogram
 parent: Bucket aggregations
-grand_parent: Aggregations
 nav_order: 12
 ---
 

_api-reference/analyze-apis.md

@@ -46,11 +46,11 @@ The following table lists the available request body fields.
 Field | Data type | Description
 :--- | :--- | :---
 `text` | String or Array of Strings | The text to analyze. If you provide an array of strings, the text is analyzed as a multi-value field. Required.
-`analyzer` | String | The name of the analyzer to apply to the `text` field. The analyzer can be built or configured in the index.<br /><br />If `analyzer` is not specified, the analyze API uses the analyzer defined in the mapping of the `field` field.<br /><br />If the `field` field is not specified, the analyze API uses the default analyzer for the index.<br /><br > If no index is specified or the index does not have a default analyzer, the analyze API uses the [standard analyzer]({{site.url}}{{site.baseurl}}/analyzers/supported-analyzers/standard/). Optional. See [Analyzers]({{site.url}}{{site.baseurl}}/analyzers/supported-analyzers/index/).
+`analyzer` | String | The name of the analyzer to apply to the `text` field. The analyzer can be built or configured in the index.<br /><br />If `analyzer` is not specified, the Analyze API uses the analyzer defined in the mapping of the `field` field.<br /><br />If the `field` field is not specified, the Analyze API uses the default analyzer for the index.<br /><br > If no index is specified or the index does not have a default analyzer, the Analyze API uses the [standard analyzer]({{site.url}}{{site.baseurl}}/analyzers/supported-analyzers/standard/). Optional. See [Analyzers]({{site.url}}{{site.baseurl}}/analyzers/supported-analyzers/index/).
 `attributes` | Array of Strings | An array of token attributes for filtering the output of the `explain` field.
 `char_filter` | Array of Strings | An array of character filters for preprocessing characters before the `tokenizer` field. Optional. See [Character filters]({{site.url}}{{site.baseurl}}/analyzers/character-filters/index/).
 `explain` | Boolean | If `true`, causes the response to include token attributes and additional details. Optional. Default is `false`.
-`field` | String | Field for deriving the analyzer. <br /><br > If you specify `field`, you must also specify the `index` path parameter. <br /><br > If you specify the `analyzer` field, it overrides the value of `field`. <br /><br > If you do not specify `field`, the analyze API uses the default analyzer for the index. <br /><br > If you do not specify the `index` field or the index does not have a default analyzer, the analyze API uses the standard analyzer. Optional.
+`field` | String | The field for deriving the analyzer. <br /><br > If you specify `field`, you must also specify the `index` path parameter. <br /><br > If you specify the `analyzer` field, it overrides the value of `field`. <br /><br > If you do not specify `field`, the Analyze API uses the default analyzer for the index. <br /><br > If you do not specify the `index` field or the index does not have a default analyzer, the Analyze API uses the standard analyzer. Optional.
 `filter` | Array of Strings | Array of token filters to apply after the `tokenizer` field. Optional. See [Token filters]({{site.url}}{{site.baseurl}}/analyzers/token-filters/index/).
 `normalizer` | String | A normalizer for converting text into a single token. Optional. See [Normalizers]({{site.url}}{{site.baseurl}}/analyzers/normalizers/). 
 `tokenizer` | String | A tokenizer for converting the `text` field into tokens. Optional. See [Tokenizers]({{site.url}}{{site.baseurl}}/analyzers/tokenizers/index/).

_api-reference/cat/cat-aliases.md

@@ -1,15 +1,15 @@
 ---
 layout: default
 title: CAT aliases
-parent: CAT API
+parent: CAT APIs
 redirect_from:
 - /opensearch/rest-api/cat/cat-aliases/
 
 nav_order: 1
 has_children: false
 ---
 
-# CAT aliases
+# CAT Aliases API
 **Introduced 1.0**
 {: .label .label-purple }
 

_api-reference/cat/cat-allocation.md

@@ -1,14 +1,14 @@
 ---
 layout: default
 title: CAT allocation
-parent: CAT API
+parent: CAT APIs
 redirect_from:
 - /opensearch/rest-api/cat/cat-allocation/
 nav_order: 5
 has_children: false
 ---
 
-# CAT allocation
+# CAT Allocation API
 **Introduced 1.0**
 {: .label .label-purple }
 

_api-reference/cat/cat-cluster_manager.md

@@ -1,14 +1,14 @@
 ---
 layout: default
 title: CAT cluster manager
-parent: CAT API
+parent: CAT APIs
 redirect_from:
  - /opensearch/rest-api/cat/cat-master/
 nav_order: 30
 has_children: false
 ---
 
-# CAT cluster_manager
+# CAT Cluster Manager API
 **Introduced 1.0**
 {: .label .label-purple }
 

_api-reference/cat/cat-count.md

@@ -1,15 +1,15 @@
 ---
 layout: default
 title: CAT count
-parent: CAT API
+parent: CAT APIs
 nav_order: 10
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-count/
 
 ---
 
-# CAT count
+# CAT Count API
 **Introduced 1.0**
 {: .label .label-purple }
 

_api-reference/cat/cat-field-data.md

@@ -1,14 +1,14 @@
 ---
 layout: default
 title: CAT field data
-parent: CAT API
+parent: CAT APIs
 nav_order: 15
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-field-data/
 ---
 
-# CAT Field Data
+# CAT Field Data API
 **Introduced 1.0**
 {: .label .label-purple }
 

_api-reference/cat/cat-health.md

@@ -1,14 +1,14 @@
 ---
 layout: default
 title: CAT health
-parent: CAT API
+parent: CAT APIs
 nav_order: 20
 has_children: false
 redirect_from:
 - /opensearch/rest-api/cat/cat-health/
 ---
 
-# CAT health
+# CAT Health API
 **Introduced 1.0**
 {: .label .label-purple }