From 6bf7598bc10d7db66094a0edd1ea154ce24ef5e9 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Tue, 3 Dec 2024 12:54:05 +0000
Subject: [PATCH] add uppercase token filter docs #8452 (#8464)

* add uppercase token filter docs #8452

Signed-off-by: Anton Rubin <anton.rubin@eliatra.com>

* Doc review

Signed-off-by: Fanit Kolchina <kolchfa@amazon.com>

---------

Signed-off-by: Anton Rubin <anton.rubin@eliatra.com>
Signed-off-by: Fanit Kolchina <kolchfa@amazon.com>
Co-authored-by: Fanit Kolchina <kolchfa@amazon.com>
(cherry picked from commit 22563d979151b883dff770de66518680cc88982a)
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
---
 _analyzers/token-filters/index.md     |  2 +-
 _analyzers/token-filters/uppercase.md | 83 +++++++++++++++++++++++++++
 2 files changed, 84 insertions(+), 1 deletion(-)
 create mode 100644 _analyzers/token-filters/uppercase.md

diff --git a/_analyzers/token-filters/index.md b/_analyzers/token-filters/index.md
index 9e6d6ccd00..1203771639 100644
--- a/_analyzers/token-filters/index.md
+++ b/_analyzers/token-filters/index.md
@@ -62,6 +62,6 @@ Token filter | Underlying Lucene token filter|  Description
 [`trim`]({{site.url}}{{site.baseurl}}/analyzers/token-filters/trim/) | [TrimFilter](https://lucene.apache.org/core/9_10_0/analysis/common/org/apache/lucene/analysis/miscellaneous/TrimFilter.html) | Trims leading and trailing white space characters from each token in a stream. 
 `truncate` | [TruncateTokenFilter](https://lucene.apache.org/core/9_10_0/analysis/common/org/apache/lucene/analysis/miscellaneous/TruncateTokenFilter.html) | Truncates tokens whose length exceeds the specified character limit. 
 `unique` | N/A | Ensures each token is unique by removing duplicate tokens from a stream. 
-`uppercase` | [UpperCaseFilter](https://lucene.apache.org/core/9_10_0/analysis/common/org/apache/lucene/analysis/core/LowerCaseFilter.html) | Converts tokens to uppercase. 
+[`uppercase`]({{site.url}}{{site.baseurl}}/analyzers/token-filters/uppercase/) | [UpperCaseFilter](https://lucene.apache.org/core/9_10_0/analysis/common/org/apache/lucene/analysis/core/LowerCaseFilter.html) | Converts tokens to uppercase. 
 `word_delimiter` | [WordDelimiterFilter](https://lucene.apache.org/core/9_10_0/analysis/common/org/apache/lucene/analysis/miscellaneous/WordDelimiterFilter.html) | Splits tokens at non-alphanumeric characters and performs normalization based on the specified rules. 
 `word_delimiter_graph` | [WordDelimiterGraphFilter](https://lucene.apache.org/core/9_10_0/analysis/common/org/apache/lucene/analysis/miscellaneous/WordDelimiterGraphFilter.html) | Splits tokens at non-alphanumeric characters and performs normalization based on the specified rules. Assigns multi-position tokens a `positionLength` attribute.
diff --git a/_analyzers/token-filters/uppercase.md b/_analyzers/token-filters/uppercase.md
new file mode 100644
index 0000000000..5026892400
--- /dev/null
+++ b/_analyzers/token-filters/uppercase.md
@@ -0,0 +1,83 @@
+---
+layout: default
+title: Uppercase
+parent: Token filters
+nav_order: 460
+---
+
+# Uppercase token filter
+
+The `uppercase` token filter is used to convert all tokens (words) to uppercase during analysis.
+
+## Example
+
+The following example request creates a new index named `uppercase_example` and configures an analyzer with an `uppercase` filter:
+
+```json
+PUT /uppercase_example
+{
+  "settings": {
+    "analysis": {
+      "filter": {
+        "uppercase_filter": {
+          "type": "uppercase"
+        }
+      },
+      "analyzer": {
+        "uppercase_analyzer": {
+          "type": "custom",
+          "tokenizer": "standard",
+          "filter": [
+            "lowercase",
+            "uppercase_filter"
+          ]
+        }
+      }
+    }
+  }
+}
+```
+{% include copy-curl.html %}
+
+## Generated tokens
+
+Use the following request to examine the tokens generated using the analyzer:
+
+```json
+GET /uppercase_example/_analyze
+{
+  "analyzer": "uppercase_analyzer",
+  "text": "OpenSearch is powerful"
+}
+```
+{% include copy-curl.html %}
+
+The response contains the generated tokens:
+
+```json
+{
+  "tokens": [
+    {
+      "token": "OPENSEARCH",
+      "start_offset": 0,
+      "end_offset": 10,
+      "type": "<ALPHANUM>",
+      "position": 0
+    },
+    {
+      "token": "IS",
+      "start_offset": 11,
+      "end_offset": 13,
+      "type": "<ALPHANUM>",
+      "position": 1
+    },
+    {
+      "token": "POWERFUL",
+      "start_offset": 14,
+      "end_offset": 22,
+      "type": "<ALPHANUM>",
+      "position": 2
+    }
+  ]
+}
+```