Merge branch 'main' into revert-code

Author: kolchfa-aws

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

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

.github/vale/styles/Vocab/OpenSearch/Words/accept.txt

@@ -44,6 +44,7 @@ Gantt
 [Gg]eospatial
 [Gg]eotile
 gibibyte
+gRPC
 [Hh]ashmap
 [Hh]ostname
 [Hh]yperparameters

DEVELOPER_GUIDE.md

@@ -8,7 +8,8 @@
   - [Query parameters](#query-parameters)
   - [Path parameters](#path-parameters)
   - [Endpoints](#endpoints)
-
+  - [Example_Code](#example_code)
+  
 ## Introduction
 
 The `.md` documents in this repository are rendered into HTML pages using [Jekyll](https://jekyllrb.com/). These HTML pages are hosted on [opensearch.org](https://docs.opensearch.org/latest/).
@@ -88,6 +89,65 @@ All spec insert components accept the following arguments:
 - `component` (String; required): The name of the component to render, such as `query_parameters`, `path_parameters`, or `endpoints`.
 - `omit_header` (Boolean; Default is `false`): If set to `true`, the markdown header of the component will not be rendered.
 
+### Example_Code
+
+- `api` should not be placed for the `component: example_code` tag. `rest` is mapped to the correct API by regex mapping.
+- `rest` (String; required): The HTTP request line (`HTTP method` + `endpoint path`) that is regex mapped to the `opensearch-openapi.yaml`.
+
+The following tags are included to help with additional needs:
+
+- `body` (String; optional): The request body for the API call, using YAML `|` to preserve newlines and indentation.
+- `include_client_setup:` (Boolean; Default is `false`): If set to `true`, the client setup for the language will be rendered.
+- `skip` (Boolean; Default is `false`): If set to `true`, the language conversions will not render/re-render. Use for manual conversions.
+
+To insert multi-language support for the `cat.allocation` API, use the following snippet:
+
+```markdown
+<!-- spec_insert_start
+component: example_code
+rest: GET /_cat/allocation?v
+-->
+<!-- spec_insert_end -->
+```
+
+To insert multi-language support for the `index` API with a request body, use the following snippet. The `|` is needed for multiline support for the body:
+
+```markdown
+<!-- spec_insert_start
+component: example_code
+rest: PUT /_settings?expand_wildcards=all&analyze_wildcard
+body: |
+  {
+    "index": {
+      "number_of_replicas": 2
+    }
+  }
+-->
+<!-- spec_insert_end -->
+```
+
+To insert multi-language support for the `index` API and include the client setup for each language, use the following snippet:
+
+```markdown
+<!-- spec_insert_start
+component: example_code
+rest: PUT /_settings?expand_wildcards=all&analyze_wildcard
+include_client_setup: true
+-->
+<!-- spec_insert_end -->
+```
+
+To insert multi-language support for the `index` API but need to manually set the multi-language example for the `index` API, use the following snippet:
+
+```markdown
+<!-- spec_insert_start
+component: example_code
+rest: PUT /_settings?expand_wildcards=all&analyze_wildcard
+skip: true
+-->
+<!-- spec_insert_end -->
+```
+
 ### Endpoints
 To insert endpoints for the `search` API, use the following snippet:
 

_about/version-history.md

@@ -9,6 +9,7 @@ permalink: /version-history/
 
 OpenSearch version | Release highlights | Release date  
 :--- | :--- | :--- 
+[3.2.0](https://github.com/opensearch-project/opensearch-build/blob/main/release-notes/opensearch-release-notes-3.2.0.md) | Updates Search Relevance Workbench. Makes gRPC APIs generally available. Introduces derived source, updates workload management, semantic field, and star tree functionality. Adds experimental Agentic Memory APIs and Job Scheduler APIs. For a full list of release highlights, see the Release Notes. | 19 August 2025
 [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 

_api-reference/cat/cat-aliases.md

@@ -37,7 +37,7 @@ include_deprecated: false
 -->
 ## Query parameters
 
-The following table lists the available query parameters. All query parameters are optional.
+The following table lists the available query parameters.
 
 | Parameter | Data type | Description | Default |
 | :--- | :--- | :--- | :--- |

_api-reference/cat/cat-allocation.md

@@ -36,7 +36,7 @@ include_deprecated: false
 -->
 ## Query parameters
 
-The following table lists the available query parameters. All query parameters are optional.
+The following table lists the available query parameters.
 
 | Parameter | Data type | Description | Default |
 | :--- | :--- | :--- | :--- |
@@ -77,7 +77,7 @@ GET _cat/allocation/node_name_1,node_name_2,node_name_3
 The following response shows that eight shards are allocated to each of the two nodes available:
 
 ```json
-shards | disk.indices | disk.used | disk.avail | disk.total | disk.percent host | ip          | node
-  8    |   989.4kb    |   25.9gb  |   32.4gb   |   58.4gb   |   44 172.18.0.4   | 172.18.0.4  | odfe-node1
-  8    |   962.4kb    |   25.9gb  |   32.4gb   |   58.4gb   |   44 172.18.0.3   | 172.18.0.3  | odfe-node2
+shards | disk.indices | disk.used | disk.avail | disk.total | disk.percent | host         | ip          | node
+  8    |   989.4kb    |   25.9gb  |   32.4gb   |   58.4gb   |   44         | 172.18.0.4   | 172.18.0.4  | odfe-node1
+  8    |   962.4kb    |   25.9gb  |   32.4gb   |   58.4gb   |   44         | 172.18.0.3   | 172.18.0.3  | odfe-node2
 ```

_api-reference/cat/cat-cluster_manager.md

@@ -34,7 +34,7 @@ include_deprecated: false
 -->
 ## Query parameters
 
-The following table lists the available query parameters. All query parameters are optional.
+The following table lists the available query parameters.
 
 | Parameter | Data type | Description | Default |
 | :--- | :--- | :--- | :--- |

_api-reference/cat/cat-count.md

@@ -36,7 +36,7 @@ include_deprecated: false
 -->
 ## Query parameters
 
-The following table lists the available query parameters. All query parameters are optional.
+The following table lists the available query parameters.
 
 | Parameter | Data type | Description | Default |
 | :--- | :--- | :--- | :--- |

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

@@ -34,7 +34,7 @@ include_deprecated: false
 -->
 ## Query parameters
 
-The following table lists the available query parameters. All query parameters are optional.
+The following table lists the available query parameters.
 
 | Parameter | Data type | Description | Default |
 | :--- | :--- | :--- | :--- |

_api-reference/cat/cat-health.md

@@ -34,7 +34,7 @@ include_deprecated: false
 -->
 ## Query parameters
 
-The following table lists the available query parameters. All query parameters are optional.
+The following table lists the available query parameters.
 
 | Parameter | Data type | Description | Default |
 | :--- | :--- | :--- | :--- |