From 9939b4791eebb9e5ecacf03fb4a64819bc8664b3 Mon Sep 17 00:00:00 2001
From: dblock <dblock@amazon.com>
Date: Thu, 17 Oct 2024 12:09:24 -0400
Subject: [PATCH] Added editorial style guide checking.

Signed-off-by: dblock <dblock@amazon.com>
---
 .cspell                                       |  16 ++
 .../styles/OpenSearch/AcronymParentheses.yml  |  75 +++++++++
 .github/vale/styles/OpenSearch/Ampersand.yml  |   6 +
 .github/vale/styles/OpenSearch/Cyber.yml      |   5 +
 .../vale/styles/OpenSearch/DashSpacing.yml    |   9 +
 .../styles/OpenSearch/DirectionAboveBelow.yml |  22 +++
 .../styles/OpenSearch/DirectionTopBottom.yml  |  16 ++
 .../vale/styles/OpenSearch/Exclamation.yml    |   6 +
 .../vale/styles/OpenSearch/FailoverNoun.yml   |   7 +
 .../vale/styles/OpenSearch/FailoverVerb.yml   |   7 +
 .../vale/styles/OpenSearch/FutureTense.yml    |   7 +
 .../styles/OpenSearch/HeadingAcronyms.yml     |  11 ++
 .../OpenSearch/HeadingCapitalization.yml      |  13 ++
 .../vale/styles/OpenSearch/HeadingColon.yml   |   7 +
 .../styles/OpenSearch/HeadingPunctuation.yml  |   9 +
 .github/vale/styles/OpenSearch/Inclusive.yml  |  15 ++
 .../OpenSearch/LatinismsElimination.yml       |  10 ++
 .../OpenSearch/LatinismsSubstitution.yml      |  15 ++
 .../OpenSearch/LinksDoubleParentheses.yml     |   8 +
 .../styles/OpenSearch/LinksDoubleSlash.yml    |   7 +
 .../vale/styles/OpenSearch/LinksEndSlash.yml  |   7 +
 .../vale/styles/OpenSearch/LinksMidSlash.yml  |   7 +
 .github/vale/styles/OpenSearch/LoginNoun.yml  |   7 +
 .github/vale/styles/OpenSearch/LoginVerb.yml  |   7 +
 .github/vale/styles/OpenSearch/LogoutNoun.yml |   7 +
 .github/vale/styles/OpenSearch/LogoutVerb.yml |   7 +
 .../vale/styles/OpenSearch/MergeConflicts.yml |   6 +
 .../vale/styles/OpenSearch/OxfordComma.yml    |   7 +
 .../vale/styles/OpenSearch/PassiveVoice.yml   |  45 +++++
 .github/vale/styles/OpenSearch/Please.yml     |   9 +
 .github/vale/styles/OpenSearch/Range.yml      |   7 +
 .github/vale/styles/OpenSearch/Repetition.yml |   6 +
 .../vale/styles/OpenSearch/RolloverNoun.yml   |   7 +
 .../vale/styles/OpenSearch/RolloverVerb.yml   |   7 +
 .github/vale/styles/OpenSearch/SetupNoun.yml  |   7 +
 .github/vale/styles/OpenSearch/SetupVerb.yml  |   7 +
 .../vale/styles/OpenSearch/SignatureV4.yml    |  11 ++
 .github/vale/styles/OpenSearch/Simple.yml     |  10 ++
 .../styles/OpenSearch/SpacingPunctuation.yml  |   9 +
 .../vale/styles/OpenSearch/SpacingSlash.yml   |   6 +
 .../vale/styles/OpenSearch/SpacingWords.yml   |   6 +
 .github/vale/styles/OpenSearch/Spelling.yml   |   5 +
 .../styles/OpenSearch/StackedHeadings.yml     |  24 +++
 .../styles/OpenSearch/SubstitutionsError.yml  |  55 +++++++
 .../OpenSearch/SubstitutionsSuggestion.yml    |  16 ++
 .../vale/styles/OpenSearch/TableHeadings.yml  |   7 +
 .../vale/styles/OpenSearch/TimeoutNoun.yml    |   7 +
 .../vale/styles/OpenSearch/TimeoutVerb.yml    |   7 +
 .github/vale/styles/OpenSearch/UnitsNames.yml |  12 ++
 .../vale/styles/OpenSearch/UnitsSpacing.yml   |   8 +
 .github/vale/styles/OpenSearch/Version.yml    |   6 +
 .../OpenSearch/acronyms/accept.txt            |   1 +
 .../OpenSearch/acronyms/reject.txt            |   1 +
 .../OpenSearch/plugins/accept.txt             |  30 ++++
 .../OpenSearch/plugins/reject.txt             |   1 +
 .../OpenSearch/products/accept.txt            | 100 +++++++++++
 .../OpenSearch/products/reject.txt            |   1 +
 .../vocabularies/OpenSearch/words/accept.txt  | 155 ++++++++++++++++++
 .../vocabularies/OpenSearch/words/reject.txt  |   1 +
 .github/vale/tests/test-headings.md           |  65 ++++++++
 .github/vale/tests/test-style-neg.md          |  95 +++++++++++
 .github/vale/tests/test-style-pos.md          |  93 +++++++++++
 .github/workflows/lint.yml                    |  10 +-
 .vale.ini                                     |  70 ++++++++
 64 files changed, 1232 insertions(+), 1 deletion(-)
 create mode 100644 .github/vale/styles/OpenSearch/AcronymParentheses.yml
 create mode 100644 .github/vale/styles/OpenSearch/Ampersand.yml
 create mode 100644 .github/vale/styles/OpenSearch/Cyber.yml
 create mode 100644 .github/vale/styles/OpenSearch/DashSpacing.yml
 create mode 100644 .github/vale/styles/OpenSearch/DirectionAboveBelow.yml
 create mode 100644 .github/vale/styles/OpenSearch/DirectionTopBottom.yml
 create mode 100644 .github/vale/styles/OpenSearch/Exclamation.yml
 create mode 100644 .github/vale/styles/OpenSearch/FailoverNoun.yml
 create mode 100644 .github/vale/styles/OpenSearch/FailoverVerb.yml
 create mode 100644 .github/vale/styles/OpenSearch/FutureTense.yml
 create mode 100644 .github/vale/styles/OpenSearch/HeadingAcronyms.yml
 create mode 100644 .github/vale/styles/OpenSearch/HeadingCapitalization.yml
 create mode 100644 .github/vale/styles/OpenSearch/HeadingColon.yml
 create mode 100644 .github/vale/styles/OpenSearch/HeadingPunctuation.yml
 create mode 100644 .github/vale/styles/OpenSearch/Inclusive.yml
 create mode 100644 .github/vale/styles/OpenSearch/LatinismsElimination.yml
 create mode 100644 .github/vale/styles/OpenSearch/LatinismsSubstitution.yml
 create mode 100644 .github/vale/styles/OpenSearch/LinksDoubleParentheses.yml
 create mode 100644 .github/vale/styles/OpenSearch/LinksDoubleSlash.yml
 create mode 100644 .github/vale/styles/OpenSearch/LinksEndSlash.yml
 create mode 100644 .github/vale/styles/OpenSearch/LinksMidSlash.yml
 create mode 100644 .github/vale/styles/OpenSearch/LoginNoun.yml
 create mode 100644 .github/vale/styles/OpenSearch/LoginVerb.yml
 create mode 100644 .github/vale/styles/OpenSearch/LogoutNoun.yml
 create mode 100644 .github/vale/styles/OpenSearch/LogoutVerb.yml
 create mode 100644 .github/vale/styles/OpenSearch/MergeConflicts.yml
 create mode 100644 .github/vale/styles/OpenSearch/OxfordComma.yml
 create mode 100644 .github/vale/styles/OpenSearch/PassiveVoice.yml
 create mode 100644 .github/vale/styles/OpenSearch/Please.yml
 create mode 100644 .github/vale/styles/OpenSearch/Range.yml
 create mode 100644 .github/vale/styles/OpenSearch/Repetition.yml
 create mode 100644 .github/vale/styles/OpenSearch/RolloverNoun.yml
 create mode 100644 .github/vale/styles/OpenSearch/RolloverVerb.yml
 create mode 100644 .github/vale/styles/OpenSearch/SetupNoun.yml
 create mode 100644 .github/vale/styles/OpenSearch/SetupVerb.yml
 create mode 100644 .github/vale/styles/OpenSearch/SignatureV4.yml
 create mode 100644 .github/vale/styles/OpenSearch/Simple.yml
 create mode 100644 .github/vale/styles/OpenSearch/SpacingPunctuation.yml
 create mode 100644 .github/vale/styles/OpenSearch/SpacingSlash.yml
 create mode 100644 .github/vale/styles/OpenSearch/SpacingWords.yml
 create mode 100644 .github/vale/styles/OpenSearch/Spelling.yml
 create mode 100644 .github/vale/styles/OpenSearch/StackedHeadings.yml
 create mode 100644 .github/vale/styles/OpenSearch/SubstitutionsError.yml
 create mode 100644 .github/vale/styles/OpenSearch/SubstitutionsSuggestion.yml
 create mode 100644 .github/vale/styles/OpenSearch/TableHeadings.yml
 create mode 100644 .github/vale/styles/OpenSearch/TimeoutNoun.yml
 create mode 100644 .github/vale/styles/OpenSearch/TimeoutVerb.yml
 create mode 100644 .github/vale/styles/OpenSearch/UnitsNames.yml
 create mode 100644 .github/vale/styles/OpenSearch/UnitsSpacing.yml
 create mode 100644 .github/vale/styles/OpenSearch/Version.yml
 create mode 100644 .github/vale/styles/config/vocabularies/OpenSearch/acronyms/accept.txt
 create mode 100644 .github/vale/styles/config/vocabularies/OpenSearch/acronyms/reject.txt
 create mode 100644 .github/vale/styles/config/vocabularies/OpenSearch/plugins/accept.txt
 create mode 100644 .github/vale/styles/config/vocabularies/OpenSearch/plugins/reject.txt
 create mode 100644 .github/vale/styles/config/vocabularies/OpenSearch/products/accept.txt
 create mode 100644 .github/vale/styles/config/vocabularies/OpenSearch/products/reject.txt
 create mode 100644 .github/vale/styles/config/vocabularies/OpenSearch/words/accept.txt
 create mode 100644 .github/vale/styles/config/vocabularies/OpenSearch/words/reject.txt
 create mode 100644 .github/vale/tests/test-headings.md
 create mode 100644 .github/vale/tests/test-style-neg.md
 create mode 100644 .github/vale/tests/test-style-pos.md
 create mode 100644 .vale.ini

diff --git a/.cspell b/.cspell
index 3d9ace5d3..b9555a029 100644
--- a/.cspell
+++ b/.cspell
@@ -51,10 +51,15 @@ fragmenter
 Fragmenter
 freqs
 generateonbehalfoftoken
+geodistance
 geohash
 geohex
 Geohex
 geoip
+geopoint
+geoshape
+geospacial
+geospatial
 geotile
 gsub
 Gsub
@@ -65,12 +70,14 @@ homoscedastic
 hotthreads
 huggingface
 hybridfs
+ignorecase
 integ
 internalusers
 Intertransport
 Jelinek
 kibanainfo
 kibanaserver
+kmeans
 koelnerphonetik
 kstem
 kuromoji
@@ -110,6 +117,7 @@ niofs
 nmslib
 nodeattrs
 nodesdn
+nonword
 noops
 nori
 Nori
@@ -127,7 +135,12 @@ Oversample
 performanceanalyzer
 permissionsinfo
 pipefail
+postmigration
+preconfigure
+preconfigured
 prefilter
+pretrain
+pretrained
 prirep
 rawfile
 readingform
@@ -182,11 +195,13 @@ termvectors
 tfidf
 Tfidf
 Tika
+timeframe
 tlbr
 tokenfilters
 translog
 Translog
 trbl
+truststore
 tubone
 Undeploys
 unigrams
@@ -199,6 +214,7 @@ urldecode
 vectory
 whoamiprotected
 wordnet
+yber
 Yrtsd
 جامد
 جامدات
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/AcronymParentheses.yml b/.github/vale/styles/OpenSearch/AcronymParentheses.yml
new file mode 100644
index 000000000..a3deecc01
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/AcronymParentheses.yml
@@ -0,0 +1,75 @@
+extends: conditional
+message: "'%s': Spell out acronyms the first time that you use them on a page and follow them with the acronym in parentheses. Subsequently, use the acronym alone."
+link: 'https://github.com/opensearch-project/documentation-website/blob/main/STYLE_GUIDE.md#acronyms'
+level: warning
+scope: summary
+ignorecase: false
+# Ensures that the existence of 'first' implies the existence of 'second'.
+first: '\b((?<!k-)[A-Z]{1,3}\/?[A-Z]{1,3}\d{0,2}\b(?!\sCommons))'
+second: '(?:\b[A-Za-z-]+ )+\(([A-Z]{1,3}\/?[A-Z]{1,3}\d{0,2})\)'
+# ... with the exception of these:
+exceptions:
+  - AND
+  - API
+  - ASCII
+  - AWS
+  - BASIC
+  - BM25
+  - BY
+  - CAT
+  - CPU
+  - CRUD
+  - CSV
+  - DELETE
+  - DNS
+  - DOS
+  - FAQ
+  - FTP
+  - GB
+  - GET
+  - GIF
+  - GROUP
+  - HAVING
+  - HTML
+  - HTTP
+  - HTTPS
+  - I/O
+  - ID
+  - IP
+  - JPEG
+  - JSON
+  - JVM
+  - KB
+  - MB
+  - N/A
+  - NAT
+  - NGINX
+  - 'NULL'
+  - OR
+  - PB
+  - PDF
+  - PNG
+  - POST
+  - PUT
+  - RAM
+  - REST
+  - RGB
+  - ROM
+  - SAML
+  - SDK
+  - SELECT
+  - SQL
+  - SSL
+  - TB
+  - TCP
+  - TIFF
+  - TLS
+  - TOC
+  - UI
+  - URI
+  - URL
+  - US
+  - UTC
+  - UTF
+  - XML
+  - YAML
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/Ampersand.yml b/.github/vale/styles/OpenSearch/Ampersand.yml
new file mode 100644
index 000000000..cd4518294
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/Ampersand.yml
@@ -0,0 +1,6 @@
+extends: existence
+message: "Don't use an ampersand in place of 'and' in documentation."
+nonword: true
+level: warning
+tokens:
+  - '\w +& +\w'
diff --git a/.github/vale/styles/OpenSearch/Cyber.yml b/.github/vale/styles/OpenSearch/Cyber.yml
new file mode 100644
index 000000000..229c29a61
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/Cyber.yml
@@ -0,0 +1,5 @@
+extends: existence
+message: "Use 'cyber' as a prefix. Remove spaces or hyphens in '%s'."
+level: error
+tokens:
+  - '[Cc]yber[- ]+[a-z]*'
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/DashSpacing.yml b/.github/vale/styles/OpenSearch/DashSpacing.yml
new file mode 100644
index 000000000..f63274668
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/DashSpacing.yml
@@ -0,0 +1,9 @@
+extends: existence
+message: "There should be no spaces around the dash in '%s'."
+ignorecase: true
+nonword: true
+level: error
+scope:
+  - ~list
+tokens:
+  - '\w+ +-{2,3} +\w+'
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/DirectionAboveBelow.yml b/.github/vale/styles/OpenSearch/DirectionAboveBelow.yml
new file mode 100644
index 000000000..50ce7808c
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/DirectionAboveBelow.yml
@@ -0,0 +1,22 @@
+extends: substitution
+message: "Use '%s' instead of '%s' for versions or orientation within a document. Use 'above' and 'below' only for physical space or screen descriptions."
+link: 'https://github.com/opensearch-project/documentation-website/blob/main/TERMS.md'
+level: warning
+ignorecase: true
+swap:
+  - image below: following image
+  - example below: following example
+  - steps below: following steps
+  - section below: following section
+  - table below: following table
+  - image above: following image
+  - example above: preceding example
+  - section above: preceding section
+  - table above: preceding table
+  - above image: preceding image
+  - above section: preceding section
+  - above table: preceding table
+  - '\d+\.\d+\s+(?:and|or)\s+above': later
+  - '\d+\.\d+\s+(?:and|or)\s+below': earlier
+  - 'below(?!\s+(?:the|this|\d))': following or later
+  - 'above(?!\s+(?:the|this|\d))': 'previous, preceding, or earlier'
diff --git a/.github/vale/styles/OpenSearch/DirectionTopBottom.yml b/.github/vale/styles/OpenSearch/DirectionTopBottom.yml
new file mode 100644
index 000000000..4e559bc6a
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/DirectionTopBottom.yml
@@ -0,0 +1,16 @@
+extends: substitution
+message: "Use '%s' instead of '%s' for window, page, or pane references to features or controls. Use 'top' and 'bottom' only as a general screen reference."
+link: 'https://github.com/opensearch-project/documentation-website/blob/main/TERMS.md'
+level: warning
+ignorecase: true
+action:
+  name: replace
+swap:
+  - top left: upper left
+  - bottom left: lower left
+  - top right: upper right
+  - bottom right: lower right
+  - top-left: upper-left
+  - bottom-left: lower-left
+  - top-right: upper-right
+  - bottom-right: lower-right
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/Exclamation.yml b/.github/vale/styles/OpenSearch/Exclamation.yml
new file mode 100644
index 000000000..7c61ce97f
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/Exclamation.yml
@@ -0,0 +1,6 @@
+extends: existence
+message: "Don't use exclamation points in documentation."
+nonword: true
+level: error
+tokens:
+  - '\w+!(?:\s|$)'
diff --git a/.github/vale/styles/OpenSearch/FailoverNoun.yml b/.github/vale/styles/OpenSearch/FailoverNoun.yml
new file mode 100644
index 000000000..069d2350f
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/FailoverNoun.yml
@@ -0,0 +1,7 @@
+extends: sequence
+message: "Use 'failover' as an adjective or noun instead of '%s'."
+level: error
+ignorecase: true
+tokens:
+  - tag: NN|JJ
+    pattern: '(?:fail over|fail-over)'
diff --git a/.github/vale/styles/OpenSearch/FailoverVerb.yml b/.github/vale/styles/OpenSearch/FailoverVerb.yml
new file mode 100644
index 000000000..6de745dd0
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/FailoverVerb.yml
@@ -0,0 +1,7 @@
+extends: sequence
+message: "Use 'fail over' as a verb instead of '%s'."
+level: error
+ignorecase: true
+tokens:
+  - tag: VB|VBD|VBG|VBN|VBP|VBZ
+    pattern: '(?:failover|fail-over)'
diff --git a/.github/vale/styles/OpenSearch/FutureTense.yml b/.github/vale/styles/OpenSearch/FutureTense.yml
new file mode 100644
index 000000000..95c8c52cb
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/FutureTense.yml
@@ -0,0 +1,7 @@
+extends: existence
+message: "'%s' is in future tense. Use present tense in documentation."
+ignorecase: true
+level: suggestion
+scope: raw
+tokens:
+  - '(?:will|is going to|won''t|[A-za-z]+''ll)\s+[a-z]+'
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/HeadingAcronyms.yml b/.github/vale/styles/OpenSearch/HeadingAcronyms.yml
new file mode 100644
index 000000000..726096410
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/HeadingAcronyms.yml
@@ -0,0 +1,11 @@
+extends: existence
+message: "'%s': Don't define acronyms in headings."
+link: 'https://github.com/opensearch-project/documentation-website/blob/main/STYLE_GUIDE.md#acronyms'
+level: error
+ignorecase: false
+scope: heading
+nonword: true
+action:
+  name: remove
+tokens:
+  - '\([A-Z]{2,5}\)'
diff --git a/.github/vale/styles/OpenSearch/HeadingCapitalization.yml b/.github/vale/styles/OpenSearch/HeadingCapitalization.yml
new file mode 100644
index 000000000..efa5a5c34
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/HeadingCapitalization.yml
@@ -0,0 +1,13 @@
+extends: capitalization
+message: "'%s' is a heading and should be in sentence case."
+level: error
+scope: heading
+match: $sentence
+indicators:
+  - )
+  - .
+  - ':'
+exceptions:
+  - '([A-Z][a-z0-9]+){2,}' # ignores all camel case words
+  - '[A-Z]{2,}' # ignores all acronyms
+  - k    # ignores lowercase k-NN
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/HeadingColon.yml b/.github/vale/styles/OpenSearch/HeadingColon.yml
new file mode 100644
index 000000000..f20ef5869
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/HeadingColon.yml
@@ -0,0 +1,7 @@
+extends: existence
+message: "Capitalize the word after a colon in '%s'."
+nonword: true
+level: error
+scope: heading
+tokens:
+  - '(?::\s)[a-z]+'
diff --git a/.github/vale/styles/OpenSearch/HeadingPunctuation.yml b/.github/vale/styles/OpenSearch/HeadingPunctuation.yml
new file mode 100644
index 000000000..451284dde
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/HeadingPunctuation.yml
@@ -0,0 +1,9 @@
+extends: existence
+message: "Don't use punctuation at the end of a heading."
+nonword: true
+level: error
+scope: heading
+action:
+  name: remove
+tokens:
+  - '[.?!]$'
diff --git a/.github/vale/styles/OpenSearch/Inclusive.yml b/.github/vale/styles/OpenSearch/Inclusive.yml
new file mode 100644
index 000000000..38ed5db05
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/Inclusive.yml
@@ -0,0 +1,15 @@
+extends: substitution
+message: "Use '%s' instead of '%s' because the latter is an offensive term."
+link: https://github.com/opensearch-project/documentation-website/blob/main/STYLE_GUIDE.md#offensive-terms
+ignorecase: true
+level: error
+swap:
+  abort: stop, end, or cancel
+  black day: blocked day
+  blacklist: deny list
+  kill: stop, end, clear, remove, or cancel
+  master account: management account
+  master: cluster manager
+  slave: replica, secondary, standby
+  white day: open day
+  whitelist: allow list
diff --git a/.github/vale/styles/OpenSearch/LatinismsElimination.yml b/.github/vale/styles/OpenSearch/LatinismsElimination.yml
new file mode 100644
index 000000000..9aaf60d6b
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/LatinismsElimination.yml
@@ -0,0 +1,10 @@
+extends: existence
+message: "Using '%s' is unnecessary. Remove."
+link: https://github.com/opensearch-project/documentation-website/blob/main/STYLE_GUIDE.md#basic-guidelines
+ignorecase: true
+nonword: true
+level: warning
+action:
+  name: remove
+tokens:
+  - '\b(?:etc\.|etc)'
diff --git a/.github/vale/styles/OpenSearch/LatinismsSubstitution.yml b/.github/vale/styles/OpenSearch/LatinismsSubstitution.yml
new file mode 100644
index 000000000..377c73bae
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/LatinismsSubstitution.yml
@@ -0,0 +1,15 @@
+extends: substitution
+message: "Use '%s' instead of '%s'."
+link: https://github.com/opensearch-project/documentation-website/blob/main/STYLE_GUIDE.md#basic-guidelines
+ignorecase: false
+level: warning
+nonword: true
+action:
+  name: replace
+swap:
+  '\b(?:eg|e\.g\.)[\s,]': for example or such as
+  '\b(?:ie|i\.e\.)[\s,]': that is or specifically
+  '\bad hoc[\s,.]': one-time
+  '\b(?:v\.|vs\.|vs|versus)\s': compared to or compared with
+  '\bvia\s': using, through, by accessing, or by choosing
+  '\bvice versa': the other way around
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/LinksDoubleParentheses.yml b/.github/vale/styles/OpenSearch/LinksDoubleParentheses.yml
new file mode 100644
index 000000000..bc4f3aed0
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/LinksDoubleParentheses.yml
@@ -0,0 +1,8 @@
+extends: existence
+message: "Remove double parentheses from the link '%s'."
+level: error
+nonword: true
+scope: raw
+tokens:
+  - '\]\({2,}[^)]*?\){1,}'
+  
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/LinksDoubleSlash.yml b/.github/vale/styles/OpenSearch/LinksDoubleSlash.yml
new file mode 100644
index 000000000..528fb73ab
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/LinksDoubleSlash.yml
@@ -0,0 +1,7 @@
+extends: existence
+message: "Remove double slashes from the link '%s'."
+level: error
+nonword: true
+scope: raw
+tokens:
+  - '\(\{\{site.url\}\}\{\{site.baseurl\}\}[^)]*?\/{2,}[^)]*?\)'
diff --git a/.github/vale/styles/OpenSearch/LinksEndSlash.yml b/.github/vale/styles/OpenSearch/LinksEndSlash.yml
new file mode 100644
index 000000000..1f20b36a1
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/LinksEndSlash.yml
@@ -0,0 +1,7 @@
+extends: existence
+message: "Add a trailing slash to the link '%s'."
+level: error
+nonword: true
+scope: raw
+tokens:
+  - '\(\{\{site.url\}\}\{\{site.baseurl\}\}(\/[A-Za-z0-9-_]+)+\s*\)'
diff --git a/.github/vale/styles/OpenSearch/LinksMidSlash.yml b/.github/vale/styles/OpenSearch/LinksMidSlash.yml
new file mode 100644
index 000000000..7ab9e9d07
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/LinksMidSlash.yml
@@ -0,0 +1,7 @@
+extends: existence
+message: "Add a slash after '{{site.url}}/{{site.baseurl}}' in '%s'."
+level: error
+nonword: true
+scope: raw
+tokens:
+  - '\(\{\{site.url\}\}\{\{site.baseurl\}\}([^\/])(?:(.*))?\)'
diff --git a/.github/vale/styles/OpenSearch/LoginNoun.yml b/.github/vale/styles/OpenSearch/LoginNoun.yml
new file mode 100644
index 000000000..5c9dd37e1
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/LoginNoun.yml
@@ -0,0 +1,7 @@
+extends: sequence
+message: "Use 'login' as an adjective or noun instead of '%s'."
+level: error
+ignorecase: true
+tokens:
+  - tag: NN|JJ
+    pattern: '(?:log in|log-in)'
diff --git a/.github/vale/styles/OpenSearch/LoginVerb.yml b/.github/vale/styles/OpenSearch/LoginVerb.yml
new file mode 100644
index 000000000..31eab927a
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/LoginVerb.yml
@@ -0,0 +1,7 @@
+extends: sequence
+message: "Use 'log in' as a verb instead of '%s'."
+level: error
+ignorecase: true
+tokens:
+  - tag: VB|VBD|VBG|VBN|VBP|VBZ
+    pattern: '(?:login|log into|log on|log onto)'
diff --git a/.github/vale/styles/OpenSearch/LogoutNoun.yml b/.github/vale/styles/OpenSearch/LogoutNoun.yml
new file mode 100644
index 000000000..9b65e5fc3
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/LogoutNoun.yml
@@ -0,0 +1,7 @@
+extends: sequence
+message: "Use 'logout' as an adjective or noun instead of '%s'."
+level: error
+ignorecase: true
+tokens:
+  - tag: NN|JJ
+    pattern: '(?:log out)'
diff --git a/.github/vale/styles/OpenSearch/LogoutVerb.yml b/.github/vale/styles/OpenSearch/LogoutVerb.yml
new file mode 100644
index 000000000..64804a2b3
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/LogoutVerb.yml
@@ -0,0 +1,7 @@
+extends: sequence
+message: "Use 'log out' as a verb instead of '%s'."
+level: error
+ignorecase: true
+tokens:
+  - tag: VB|VBD|VBG|VBN|VBP|VBZ
+    pattern: '(?:logout)'
diff --git a/.github/vale/styles/OpenSearch/MergeConflicts.yml b/.github/vale/styles/OpenSearch/MergeConflicts.yml
new file mode 100644
index 000000000..f76918bbd
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/MergeConflicts.yml
@@ -0,0 +1,6 @@
+extends: existence
+message: Resolve lingering merge conflicts.
+nonword: true
+level: error
+tokens:
+  - <<<<<<< HEAD
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/OxfordComma.yml b/.github/vale/styles/OpenSearch/OxfordComma.yml
new file mode 100644
index 000000000..7fe4d249a
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/OxfordComma.yml
@@ -0,0 +1,7 @@
+extends: existence
+message: "Add an Oxford comma in '%s'."
+scope: sentence
+level: warning
+nonword: true
+tokens:
+  - '(?:[^\s,]+,){1,} \w+ (?:and|or) \w+[.?!]'
diff --git a/.github/vale/styles/OpenSearch/PassiveVoice.yml b/.github/vale/styles/OpenSearch/PassiveVoice.yml
new file mode 100644
index 000000000..a891f017a
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/PassiveVoice.yml
@@ -0,0 +1,45 @@
+extends: existence
+message: "'%s': Whenever possible, use the active voice instead of the passive voice."
+ignorecase: true
+level: suggestion
+raw:
+  - \b(am|are|were|being|is|been|was|be)\b\s*
+tokens:
+  - '[\w]+ed'
+  - become
+  - been
+  - begun
+  - brought
+  - built
+  - cast
+  - caught
+  - chosen
+  - come
+  - cut
+  - dealt
+  - done
+  - drawn
+  - forbidden
+  - found
+  - given
+  - gone
+  - gotten
+  - held
+  - hidden
+  - kept
+  - known
+  - led
+  - let
+  - made
+  - put
+  - quit
+  - read
+  - seen
+  - sent
+  - sped
+  - spent
+  - stuck
+  - swept
+  - taken
+  - understood
+  - written
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/Please.yml b/.github/vale/styles/OpenSearch/Please.yml
new file mode 100644
index 000000000..c49496281
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/Please.yml
@@ -0,0 +1,9 @@
+extends: existence
+message: "Using '%s' is unnecessary. Remove."
+link: https://github.com/opensearch-project/documentation-website/blob/main/TERMS.md
+ignorecase: true
+level: warning
+action:
+  name: remove
+tokens:
+  - please
diff --git a/.github/vale/styles/OpenSearch/Range.yml b/.github/vale/styles/OpenSearch/Range.yml
new file mode 100644
index 000000000..e750ef5e6
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/Range.yml
@@ -0,0 +1,7 @@
+extends: existence
+message: Use an en dash (--) with no space on either side in a range of numbers.
+link: https://github.com/opensearch-project/documentation-website/blob/main/STYLE_GUIDE.md#numbers-and-measurement
+nonword: true
+level: error
+tokens:
+  - '\b\d+ *[-] *\d+\b'
diff --git a/.github/vale/styles/OpenSearch/Repetition.yml b/.github/vale/styles/OpenSearch/Repetition.yml
new file mode 100644
index 000000000..922b0ebed
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/Repetition.yml
@@ -0,0 +1,6 @@
+extends: repetition
+message: "'%s' is repeated."
+level: error
+alpha: true
+tokens:
+  - '[^\s]+'
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/RolloverNoun.yml b/.github/vale/styles/OpenSearch/RolloverNoun.yml
new file mode 100644
index 000000000..437363e1e
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/RolloverNoun.yml
@@ -0,0 +1,7 @@
+extends: sequence
+message: "Use 'rollover' as an adjective or noun instead of '%s'."
+level: error
+ignorecase: true
+tokens:
+  - tag: NN|JJ
+    pattern: '(?:roll over|roll-over)'
diff --git a/.github/vale/styles/OpenSearch/RolloverVerb.yml b/.github/vale/styles/OpenSearch/RolloverVerb.yml
new file mode 100644
index 000000000..a3ead9fb5
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/RolloverVerb.yml
@@ -0,0 +1,7 @@
+extends: sequence
+message: "Use 'roll over' as a verb instead of '%s'."
+level: error
+ignorecase: true
+tokens:
+  - tag: VB|VBD|VBG|VBN|VBP|VBZ
+    pattern: '(?:rollover|roll-over)'
diff --git a/.github/vale/styles/OpenSearch/SetupNoun.yml b/.github/vale/styles/OpenSearch/SetupNoun.yml
new file mode 100644
index 000000000..94c1c8516
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/SetupNoun.yml
@@ -0,0 +1,7 @@
+extends: sequence
+message: "Use 'setup' as an adjective or noun instead of '%s'."
+level: error
+ignorecase: true
+tokens:
+  - tag: NN|JJ
+    pattern: '(?:set up|set-up)'
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/SetupVerb.yml b/.github/vale/styles/OpenSearch/SetupVerb.yml
new file mode 100644
index 000000000..f39d76ba2
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/SetupVerb.yml
@@ -0,0 +1,7 @@
+extends: sequence
+message: "Use 'set up' as a verb instead of '%s'."
+level: error
+ignorecase: true
+tokens:
+  - tag: VB|VBD|VBG|VBN|VBP|VBZ
+    pattern: '(?:setup|set-up)'
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/SignatureV4.yml b/.github/vale/styles/OpenSearch/SignatureV4.yml
new file mode 100644
index 000000000..c3a3573a7
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/SignatureV4.yml
@@ -0,0 +1,11 @@
+extends: substitution
+message: "'%s': Use 'AWS Signature Version 4' instead of '%s' on first appearance. Then, Signature Version 4 may be used. Only use SigV4 when space is limited."
+ignorecase: true
+link: 'https://github.com/opensearch-project/documentation-website/blob/main/TERMS.md'
+level: warning
+action:
+  name: replace
+swap:
+  sigv4: Signature Version 4
+  AWS sigv4: AWS Signature Version 4
+  
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/Simple.yml b/.github/vale/styles/OpenSearch/Simple.yml
new file mode 100644
index 000000000..5b9f63e6e
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/Simple.yml
@@ -0,0 +1,10 @@
+extends: existence
+message: "Don't use '%s' because it's not neutral in tone. If you mean 'only', use 'only' instead."
+link: https://github.com/opensearch-project/documentation-website/blob/main/TERMS.md
+ignorecase: true
+level: warning
+action:
+  name: remove
+tokens:
+  - just
+  - simply
diff --git a/.github/vale/styles/OpenSearch/SpacingPunctuation.yml b/.github/vale/styles/OpenSearch/SpacingPunctuation.yml
new file mode 100644
index 000000000..43a795001
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/SpacingPunctuation.yml
@@ -0,0 +1,9 @@
+extends: existence
+message: "There should be no space before and one space after the punctuation mark in '%s'."
+level: error
+nonword: true
+tokens:
+  - '[A-Za-z]+[,;] {2,}[A-Za-z]+'
+  - '[A-Za-z]+[,;][A-Za-z]+'
+  - '[A-Za-z]+[.?] {2,}[A-Za-z]+'
+  - '[A-Za-z]+[.?][A-Za-z]+'
diff --git a/.github/vale/styles/OpenSearch/SpacingSlash.yml b/.github/vale/styles/OpenSearch/SpacingSlash.yml
new file mode 100644
index 000000000..f0a0f28f6
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/SpacingSlash.yml
@@ -0,0 +1,6 @@
+extends: existence
+message: "When using '/' between words, do not insert space on either side of it."
+ignorecase: true
+level: error
+tokens:
+  - '[A-Za-z]+ +\/ +[A-Za-z]+'
diff --git a/.github/vale/styles/OpenSearch/SpacingWords.yml b/.github/vale/styles/OpenSearch/SpacingWords.yml
new file mode 100644
index 000000000..7e4ed5967
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/SpacingWords.yml
@@ -0,0 +1,6 @@
+extends: existence
+message: "There should be one space between words in '%s'."
+level: error
+nonword: true
+tokens:
+  - '[A-Za-z]+ {2,}[A-Za-z]+'
diff --git a/.github/vale/styles/OpenSearch/Spelling.yml b/.github/vale/styles/OpenSearch/Spelling.yml
new file mode 100644
index 000000000..ea425e022
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/Spelling.yml
@@ -0,0 +1,5 @@
+extends: spelling
+message: 'Error: %s. If you are referencing a setting, variable, format, function, or repository, surround it with tic marks.'
+level: error
+action:
+  name: suggest
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/StackedHeadings.yml b/.github/vale/styles/OpenSearch/StackedHeadings.yml
new file mode 100644
index 000000000..ac7dd72c4
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/StackedHeadings.yml
@@ -0,0 +1,24 @@
+extends: script
+message: Do not stack headings. Insert an introductory sentence between headings.
+level: error
+link: https://github.com/opensearch-project/documentation-website/blob/main/STYLE_GUIDE.md#formatting-and-organization
+scope: raw
+script: |
+  text := import("text")
+  matches := []
+  // Replace code blocks with dummy text to avoid processing comments
+  document := text.re_replace("(?s) *(```.*?```)", scope, "text")
+  isHeading := false
+  for line in text.split(document, "\n") {
+    if text.trim_space(line) != "" {   
+      if text.has_prefix(line, "#") {
+        if isHeading == true {
+          start := text.index(scope, line)
+          matches = append(matches, {begin: start, end: start + len(line)})
+         }
+        isHeading = true // new section; reset count
+      } else {
+        isHeading = false
+      }
+    }
+  }  
diff --git a/.github/vale/styles/OpenSearch/SubstitutionsError.yml b/.github/vale/styles/OpenSearch/SubstitutionsError.yml
new file mode 100644
index 000000000..6e8872d32
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/SubstitutionsError.yml
@@ -0,0 +1,55 @@
+extends: substitution
+message: "Use '%s' instead of '%s'."
+ignorecase: true
+level: error
+action:
+  name: replace
+swap:
+  command-line interface: command line interface
+  data are: data is
+  data set: dataset
+  for information on: for information about
+  for more information on: for more information about
+  geo distance: geodistance
+  geo hash: geohash
+  geo hex: geohex
+  geo point: geopoint
+  geo shape: geoshape
+  geo tile: geotile
+  geospacial: geospatial
+  hard code: hardcode
+  high-performance computing: high performance computing
+  host name: hostname
+  Huggingface: Hugging Face
+  indices: indexes
+  ingestion pipeline: ingest pipeline
+  key store: keystore
+  key/value: key-value
+  kmeans: k-means
+  kNN: k-NN
+  machine-learning: machine learning
+  nonproduction: non-production
+  postmigration: post-migration
+  pre-configure: preconfigure
+  pre-configured: preconfigured
+  pre-defined: predefined
+  pre-train: pretrain
+  pre-trained: pretrained
+  premigration: pre-migration
+  re-enable: reenable
+  screen shot: screenshot
+  sample request: example request
+  sample response: example response
+  stacktrace: stack trace
+  stand-alone: standalone
+  timeframe: time frame
+  time series data: time-series data
+  time stamp: timestamp
+  timezone: time zone
+  tradeoff: trade-off
+  trust store: truststore
+  U.S.: US
+  web page: webpage
+  web site: website
+  whitespace: white space
+  'user interface \(UI\)': UI
diff --git a/.github/vale/styles/OpenSearch/SubstitutionsSuggestion.yml b/.github/vale/styles/OpenSearch/SubstitutionsSuggestion.yml
new file mode 100644
index 000000000..dd3da2bfb
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/SubstitutionsSuggestion.yml
@@ -0,0 +1,16 @@
+extends: substitution
+message: "Use '%s' instead of '%s'."
+ignorecase: true
+level: suggestion
+action:
+  name: replace
+swap:
+  app server: application server
+  as well as: and
+  due to: because of
+  it is recommended: we recommend
+  leverage: use
+  life cycle: lifecycle
+  navigate in: navigate to
+  'wish|desire': want
+  
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/TableHeadings.yml b/.github/vale/styles/OpenSearch/TableHeadings.yml
new file mode 100644
index 000000000..96cb8621f
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/TableHeadings.yml
@@ -0,0 +1,7 @@
+extends: capitalization
+message: "'%s' is a table heading and should be in sentence case."
+level: error
+scope: table.header
+match: $sentence
+exceptions:
+  - k    # ignores lowercase k-NN
diff --git a/.github/vale/styles/OpenSearch/TimeoutNoun.yml b/.github/vale/styles/OpenSearch/TimeoutNoun.yml
new file mode 100644
index 000000000..fa6c61c67
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/TimeoutNoun.yml
@@ -0,0 +1,7 @@
+extends: sequence
+message: "Use 'timeout' as an adjective or noun instead of '%s'."
+level: error
+ignorecase: true
+tokens:
+  - tag: NN|JJ
+    pattern: '(?:time out|time-out)'
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/TimeoutVerb.yml b/.github/vale/styles/OpenSearch/TimeoutVerb.yml
new file mode 100644
index 000000000..f42b38f10
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/TimeoutVerb.yml
@@ -0,0 +1,7 @@
+extends: sequence
+message: "Use 'time out' as a verb instead of '%s'."
+level: error
+ignorecase: true
+tokens:
+  - tag: VB|VBD|VBG|VBN|VBP|VBZ
+    pattern: '(?:timeout|time-out)'
\ No newline at end of file
diff --git a/.github/vale/styles/OpenSearch/UnitsNames.yml b/.github/vale/styles/OpenSearch/UnitsNames.yml
new file mode 100644
index 000000000..b82ea56b4
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/UnitsNames.yml
@@ -0,0 +1,12 @@
+extends: substitution
+message: "Use '%s' instead of '%s'."
+level: error
+ignorecase: false
+action:
+  name: replace
+swap:
+  kb: KB
+  mb: MB
+  gb: GB
+  tb: TB
+  pb: PB
diff --git a/.github/vale/styles/OpenSearch/UnitsSpacing.yml b/.github/vale/styles/OpenSearch/UnitsSpacing.yml
new file mode 100644
index 000000000..2d6377176
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/UnitsSpacing.yml
@@ -0,0 +1,8 @@
+extends: existence
+message: "Put a space between the number and the units in '%s'."
+nonword: true
+ignorecase: true
+level: warning
+tokens:
+  - \d+(?:B|KB|MB|GB|TB|PB)(?:\s|\.|,)
+  - \d+(?:ns|ms|s|min|h|d)(?:\s|\.|,)
diff --git a/.github/vale/styles/OpenSearch/Version.yml b/.github/vale/styles/OpenSearch/Version.yml
new file mode 100644
index 000000000..a5c91c09d
--- /dev/null
+++ b/.github/vale/styles/OpenSearch/Version.yml
@@ -0,0 +1,6 @@
+extends: existence
+message: "In '%s', spell out 'version'."
+ignorecase: true
+level: warning
+tokens:
+  - '[v|V][0-9]+\.[0-9]+'
diff --git a/.github/vale/styles/config/vocabularies/OpenSearch/acronyms/accept.txt b/.github/vale/styles/config/vocabularies/OpenSearch/acronyms/accept.txt
new file mode 100644
index 000000000..3525028e4
--- /dev/null
+++ b/.github/vale/styles/config/vocabularies/OpenSearch/acronyms/accept.txt
@@ -0,0 +1 @@
+(?-i)[A-Z]{2,}s
\ No newline at end of file
diff --git a/.github/vale/styles/config/vocabularies/OpenSearch/acronyms/reject.txt b/.github/vale/styles/config/vocabularies/OpenSearch/acronyms/reject.txt
new file mode 100644
index 000000000..8b1378917
--- /dev/null
+++ b/.github/vale/styles/config/vocabularies/OpenSearch/acronyms/reject.txt
@@ -0,0 +1 @@
+
diff --git a/.github/vale/styles/config/vocabularies/OpenSearch/plugins/accept.txt b/.github/vale/styles/config/vocabularies/OpenSearch/plugins/accept.txt
new file mode 100644
index 000000000..3685cdee7
--- /dev/null
+++ b/.github/vale/styles/config/vocabularies/OpenSearch/plugins/accept.txt
@@ -0,0 +1,30 @@
+Alerting plugin
+Anomaly Detection plugin
+Asynchronous Search plugin
+Crypto plugin
+Cross-Cluster Replication plugin
+Custom Codecs plugin
+Flow Framework plugin
+Maps plugin
+Notebooks plugin
+Notifications plugin
+Reports plugin
+Reports Scheduler plugin
+Geospatial plugin
+Index Management plugin
+Job Scheduler
+Job Scheduler plugin
+k-NN plugin
+ML Commons
+ML Commons plugin
+Neural Search plugin
+Observability plugin
+Performance Analyzer plugin
+Query Insights plugin
+Query Workbench plugin
+Search Relevance plugin
+Security plugin
+Security Analytics plugin
+SQL plugin
+Trace Analytics plugin
+User Behavior Insights
\ No newline at end of file
diff --git a/.github/vale/styles/config/vocabularies/OpenSearch/plugins/reject.txt b/.github/vale/styles/config/vocabularies/OpenSearch/plugins/reject.txt
new file mode 100644
index 000000000..8b1378917
--- /dev/null
+++ b/.github/vale/styles/config/vocabularies/OpenSearch/plugins/reject.txt
@@ -0,0 +1 @@
+
diff --git a/.github/vale/styles/config/vocabularies/OpenSearch/products/accept.txt b/.github/vale/styles/config/vocabularies/OpenSearch/products/accept.txt
new file mode 100644
index 000000000..e33ac0974
--- /dev/null
+++ b/.github/vale/styles/config/vocabularies/OpenSearch/products/accept.txt
@@ -0,0 +1,100 @@
+Active Directory
+Adoptium
+AI21 Labs Jurassic
+Amazon
+Amazon OpenSearch Serverless
+Amazon OpenSearch Service
+Amazon Bedrock
+Amazon SageMaker
+Ansible
+Anthropic Claude
+Auditbeat
+AWS Cloud
+Cohere Command
+Cohere Embed English
+Cohere Embed Multilingual
+Cognito
+Dashboards Query Language
+Data Prepper
+Debian
+Dev Tools
+Docker
+Docker Compose
+Dockerfile
+DoS
+Elasticsearch
+GeoJSON
+GitHub
+Gradle
+Grafana
+Faiss
+Filebeat
+Flickr
+Fluent Bit
+Fluentd
+Helm
+Hugging Face
+IdP
+Inferentia
+IP2Geo
+IPv4
+IPv6
+Iris
+JavaScript
+Jaeger
+Jaeger HotROD
+JSON
+JSON Web Token
+Keycloak
+Kerberos
+Kibana
+Kubernetes
+Lambda
+Linux
+Log4j
+Logstash
+Lucene
+macOS
+Metricbeat
+Microsoft Power BI
+Minikube
+Nagios
+Okta
+Open Distro
+OpenAI
+OpenID Connect
+OpenSearch
+OpenSearch Assistant
+OpenSearch Assistant Toolkit
+OpenSearch Benchmark
+OpenSearch Dashboards
+OpenSearch Playground
+OpenSearch Project
+OpenSearch Service
+OpenSSL
+OpenTelemetry
+OpenTelemetry Collector
+OTel
+Packetbeat
+Painless
+Peer Forwarder
+Performance Analyzer
+Piped Processing Language
+Powershell
+Python
+PyTorch
+Querqy
+Query Workbench
+RCF Summarize
+RPM Package Manager
+Ruby
+Simple Schema for Observability
+Tableau
+Textract
+Titan Multimodal Embeddings
+Titan Text Embeddings
+TorchScript
+Tribuo
+VisBuilder
+Winlogbeat
+Zstandard
\ No newline at end of file
diff --git a/.github/vale/styles/config/vocabularies/OpenSearch/products/reject.txt b/.github/vale/styles/config/vocabularies/OpenSearch/products/reject.txt
new file mode 100644
index 000000000..8b1378917
--- /dev/null
+++ b/.github/vale/styles/config/vocabularies/OpenSearch/products/reject.txt
@@ -0,0 +1 @@
+
diff --git a/.github/vale/styles/config/vocabularies/OpenSearch/words/accept.txt b/.github/vale/styles/config/vocabularies/OpenSearch/words/accept.txt
new file mode 100644
index 000000000..c6d129c2c
--- /dev/null
+++ b/.github/vale/styles/config/vocabularies/OpenSearch/words/accept.txt
@@ -0,0 +1,155 @@
+[Aa]nonymization
+[Aa]utomapping
+[Aa]utopopulate
+[Bb]ackoff
+[Bb]ackporting
+[Bb]ackpressure
+[Bb]asemap
+[Bb]enchmarked
+[Bb]igram
+Boolean
+[Cc]allout
+[Cc]hatbots?
+[Cc]odec
+[Cc]omposable
+[Cc]onfig
+[Cc]ron
+[Cc]ybersecurity
+[Dd]ashboarding
+[Dd]atagram
+[Dd]eallocate
+[Dd]eduplicates?
+[Dd]eduplication
+[Dd]eprovision(s|ed|ing)?
+[Dd]eserialize
+[Dd]eserialization
+Dev
+[Dd]iscoverability
+Distro
+[Dd]ownvote(s|d)?
+[Dd]uplicative
+[Ee]gress
+[Ee]num
+[Ff]ailover
+[Ff]lyout
+[Ff]sync
+Gantt
+[Gg]eobounds
+[Gg]eodistance
+[Gg]eohash
+[Gg]eohex
+[Gg]eopoint
+[Gg]eopolygon
+[Gg]eoshape
+[Gg]eospatial
+[Gg]eotile
+gibibyte
+[Hh]ashmap
+[Hh]ostname
+[Hh]yperparameters
+[Ii]mpactful
+[Ii]ngress
+[Ii]nitializer
+[Ii]nline
+[Ii]nstrumentations?
+[Ii]ntracluster
+[Jj]avadoc
+k-NN
+[Kk]eystore
+kibibyte
+mebibyte
+[Ll]earnings
+[Ll]emmatization
+Levenshtein
+[Ll]inestring
+[Ll]ookups?
+[Ll]ossy
+[Ll]owercases?d?
+[Mm]acrobenchmarks?
+[Mm]etaphone
+[Mm]isorder
+[Mm]ultifield
+[Mm]ultiline
+[Mm]ultimodal
+[Mm]ultipoint
+[Mm]ultipolygon
+[Mm]ultithreaded
+[Mm]ultivalued
+[Mm]ultiword
+[Nn]amespace
+[Oo]ffline
+[Oo]nboarding
+[Oo]versamples?
+pebibyte
+p\d{2}
+[Pp]erformant
+[Pp]laintext
+[Pp]luggable
+[Pp]reconfigure
+[Pp]refetch
+[Pp]refilter
+[Pp]reload
+[Pp]repackaged?
+[Pp]repend
+[Pp]repper
+[Pp]reprocess
+[Pp]retrain
+[Pp]seudocode
+[Qq]uantiles?
+[Qq]uantiz(e|ation|ing|er)
+[Rr]ebalance
+[Rr]ebalancing
+[Rr]edownload
+[Rr]eenable
+[Rr]eindex
+[Rr]eingest
+[Rr]eprovision(ed|ing)?
+[Rr]erank(er|ed|ing)?
+[Rr]epo
+[Rr]escor(e|ed|ing)?
+[Rr]ewriter
+[Rr]ollout
+[Rr]ollup
+[Rr]unbooks?
+[Ss]harding
+[Ss]erverless
+[Ss]harding
+[Ss]ignificand
+[Ss]napshott(ed|ing)
+stdout
+[Ss]temmers?
+[Ss]ubaggregation
+[Ss]ubcalculation
+[Ss]ubcollectors?
+[Ss]ubcommands?
+[Ss]ubfield
+[Ss]ubquer(y|ies)
+[Ss]ubstrings?
+[Ss]ubtag
+[Ss]ubtree
+[Ss]ubvector
+[Ss]ubwords?
+[Ss]uperset
+[Ss]uperadmins?
+[Ss]yslog
+tebibyte
+[Tt]emplated
+[Tt]okenization
+[Tt]okenizer?
+[Tt]ooltip
+[Tt]ranslog
+[Tt]ruststore
+[Uu]nary
+[Uu]ncheck
+[Uu]ncomment
+[Uu]ndeploy
+[Uu]nigram
+[Uu]nnesting
+[Uu]nrecovered
+[Uu]nregister(s|ed|ing)?
+[Uu]pdatable
+[Uu]psert
+[Uu]pvote(s|d)?
+[Ww]alkthrough
+[Ww]ebpage
+xy
\ No newline at end of file
diff --git a/.github/vale/styles/config/vocabularies/OpenSearch/words/reject.txt b/.github/vale/styles/config/vocabularies/OpenSearch/words/reject.txt
new file mode 100644
index 000000000..8b1378917
--- /dev/null
+++ b/.github/vale/styles/config/vocabularies/OpenSearch/words/reject.txt
@@ -0,0 +1 @@
+
diff --git a/.github/vale/tests/test-headings.md b/.github/vale/tests/test-headings.md
new file mode 100644
index 000000000..7d16ca15a
--- /dev/null
+++ b/.github/vale/tests/test-headings.md
@@ -0,0 +1,65 @@
+# This should not be flagged
+
+---
+
+# Example with OpenSearch should not be flagged
+
+---
+
+# Example with Canada should not be flagged
+
+---
+
+# Example with: OpenSearch should not be flagged
+
+---
+
+# This: Should not be flagged
+
+---
+
+# Step 2: (Optional) Test OpenSearch should not be flagged
+
+---
+
+# Example with something else: Should not be flagged
+
+---
+
+# Example 2: Should not be flagged
+
+---
+
+# 1. This should not be flagged
+
+---
+
+# Example: should be flagged
+
+---
+
+# Example 3: should be flagged
+
+---
+
+# Example with something else: should be Flagged twice
+
+---
+
+# Example With something else: should be flagged twice
+
+---
+
+# Example: with OpenSearch should be flagged
+
+---
+
+# this should be flagged
+
+---
+
+# This Should Be Flagged
+
+---
+
+The King of England should not be flagged. 
\ No newline at end of file
diff --git a/.github/vale/tests/test-style-neg.md b/.github/vale/tests/test-style-neg.md
new file mode 100644
index 000000000..39bf65f96
--- /dev/null
+++ b/.github/vale/tests/test-style-neg.md
@@ -0,0 +1,95 @@
+# Test file
+
+This sentence tests Advanced Placement (AP). We should define AP before using.
+
+This sentence tests cybersecurity.
+
+This sentence tests dash---spacing.
+
+This sentence tests:
+
+    - Dash --- spacing in a list.
+
+This sentence tests numbers above 1.2 in versions 1.2 and earlier.
+
+This sentence tests upper-right and lower left.
+
+This sentence tests exclamation points.
+
+This sentence tests failover. To fail over, we test this as a verb.
+
+This sentence is not testing the future tense.
+
+## This heading tests heading acronyms Security plugin
+
+This sentence tests inclusive terminology by not using offensive terms.
+
+## This heading tests capitalization
+
+This sentence tests Latin elimination.
+
+## This heading tests ending punctuation
+
+This sentence tests Latin substitution through using Latin.
+
+## This heading: Tests colons but fails capitalization
+
+This sentence tests [links double parentheses]({{site.url}}{{site.baseurl}}/opensearch/).
+
+This sentence tests [links double slash]({{site.url}}{{site.baseurl}}/opensearch/).
+
+This sentence tests [links end slash]({{site.url}}{{site.baseurl}}/opensearch/).
+
+This sentence tests [links mid slash]({{site.url}}{{site.baseurl}}/opensearch/).
+
+This sentence tests using login as a noun. To log in, we test this as a verb.
+
+To test merge conflicts, remove tick marks in `<<<<<<< HEAD`.
+
+This sentence tests periods, colons, and commas.
+
+This sentence tests passive voice.
+
+We are pleased that this sentence tests pleading.
+
+This sentence tests the range 2--5.
+
+This sentence tests repetition of words in the middle of a sentence.
+
+This sentence tests rollover as a noun. To roll over, we test this as a verb.
+
+This sentence tests setup as a noun. To set up, we test this as a verb.
+
+This sentence tests AWS Signature Version 4.
+
+This sentence tests the "simple" rule by doing it.
+
+These two sentences. Test the spacing punctuation.
+
+This sentence tests the correct/incorrect slash spacing.
+
+This sentence tests word spacing.
+
+This sentence tests spelling.
+
+## This and the next
+
+This sentence tests substitution error by using the word indexes.
+
+### Headings test stacked headings
+
+This sentence tests substitution suggestion because of its nature.
+
+This table | Tests capitalization
+:--- | :---
+of table | headings
+
+This sentence tests timeout as a noun. To time out, we test this as a verb.
+
+This sentence tests 2 KB units capitalization.
+
+This sentence tests 2 KB units spacing.
+
+This sentence tests version 1.2 not spelled out.
+
+This sentence tests terms by using Security plugin.
\ No newline at end of file
diff --git a/.github/vale/tests/test-style-pos.md b/.github/vale/tests/test-style-pos.md
new file mode 100644
index 000000000..1cf640f46
--- /dev/null
+++ b/.github/vale/tests/test-style-pos.md
@@ -0,0 +1,93 @@
+# Test file
+
+This sentence tests AP. AP should be defined before using.
+
+This sentence tests cyber security.
+
+This sentence tests dash --- spacing.
+
+This sentence tests the table above in versions 1.2 and below.
+
+This sentence tests top-right and bottom left.
+
+This sentence tests exclamation points!
+
+This sentence tests fail-over. To failover, we test this as a verb.
+
+This sentence will test the future tense.
+
+## This heading tests heading acronyms (HA)
+
+This sentence tests inclusive terminology by using an offensive term kill.
+
+## This heading tests Capitalization
+
+This sentence tests Latin elimination, etc. 
+
+## This heading tests ending punctuation.
+
+This sentence tests Latin substitution via using Latin.
+
+## This heading: tests colons
+
+This sentence tests [links double parentheses](({{site.url}}{{site.baseurl}}/opensearch/)).
+
+This sentence tests [links double slash]({{site.url}}{{site.baseurl}}/opensearch//double-slash/).
+
+This sentence tests [links end slash]({{site.url}}{{site.baseurl}}/opensearch).
+
+This sentence tests [links mid slash]({{site.url}}{{site.baseurl}}opensearch).
+
+This sentence tests log-in as a noun. To login, we test this as a verb.
+
+To test merge conflicts, remove tick marks in `<<<<<<< HEAD`.
+
+This sentence tests periods, colons and commas.
+
+This sentence is tested with passive voice.
+
+Please test this sentence.
+
+This sentence tests the range 2 -- 5.
+
+This sentence tests repetition repetition of words in the middle of a sentence.
+
+This sentence tests roll-over as a noun. To rollover, we test this as a verb.
+
+This sentence tests set-up as a noun. To setup, we test this as a verb.
+
+This sentence tests AWS SigV4 and sigv4. 
+
+This sentence simply tests the "simple" rule by just doing it.
+
+These two sentences.  Test the spacing punctuation.
+
+This sentence tests the correct / incorrect slash spacing.
+
+This sentence tests  word spacing.
+
+This sentence tests splling.
+
+## This and the next
+
+### Headings test stacked headings
+
+This sentence tests substitution error by using the word indices.
+
+This sentence tests substitution suggestion due to its nature.
+
+This Table | tests capitalization
+:--- | :---
+of table | headings
+
+This sentence tests time-out as a noun. To timeout, we test this as a verb.
+
+This sentence tests 2 kb units capitalization.
+
+This sentence tests 2KB units spacing.
+
+This sentence tests v1.2 not spelled out.
+
+This sentence tests terms by using security plugin.
+
+This sentence tests using the word repo. 
\ No newline at end of file
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index b04c3d121..fe10b5fe6 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -6,12 +6,14 @@ on:
     paths:
       - '**/*.ts'
       - '**/*.yaml'
+      - '**/*.yml'
   pull_request:
     branches: ['**']
     paths:
       - '**/*.ts'
       - '**/*.yaml'
-  
+      - '**/*.yml'
+
 jobs:
   lint:
     runs-on: ubuntu-latest
@@ -29,3 +31,9 @@ jobs:
 
       - name: Lint
         run: npm run lint
+
+      - name: Check Style
+        uses: errata-ai/vale-action@v2.1.1
+        with:
+          version: 3.7.1
+          files: spec,tests
diff --git a/.vale.ini b/.vale.ini
new file mode 100644
index 000000000..075aa57d8
--- /dev/null
+++ b/.vale.ini
@@ -0,0 +1,70 @@
+StylesPath = ".github/vale/styles"
+Vocab = "OpenSearch"
+MinAlertLevel = warning
+SkippedScopes = code, style
+
+[*]
+BasedOnStyles = Vale, OpenSearch
+
+BlockIgnores = {%-?\s*comment[.|\s|\S]*?endcomment\s*-?%}, \
+    {%\s*raw[.|\s|\S]*?endraw\s*%}, \
+    {:+\s*[\.\w-\s]*\s*}, \
+    {%\s+[^%]*%} 
+
+# ignore variables
+TokenIgnores = [a-zA-Z_]+((?:_|\.)[a-zA-Z]+)+
+         
+# override Vale spelling               
+Vale.Spelling = NO 
+Vale.Repetition = NO
+Vale.Terms = YES
+OpenSearch.AcronymParentheses = YES
+OpenSearch.Ampersand = YES
+OpenSearch.Cyber = YES
+OpenSearch.DashSpacing = YES
+OpenSearch.DirectionAboveBelow = YES
+OpenSearch.DirectionTopBottom = YES
+OpenSearch.Exclamation = YES
+OpenSearch.FailoverNoun = YES
+OpenSearch.FailoverVerb = YES
+OpenSearch.FutureTense = NO
+OpenSearch.HeadingAcronyms = YES
+OpenSearch.HeadingCapitalization = YES
+OpenSearch.HeadingColon = YES
+OpenSearch.HeadingPunctuation = YES
+OpenSearch.Inclusive = YES
+OpenSearch.LatinismsElimination = YES
+OpenSearch.LatinismsSubstitution = YES
+OpenSearch.LinksDoubleParentheses = YES
+OpenSearch.LinksDoubleSlash = YES
+OpenSearch.LinksEndSlash = YES
+OpenSearch.LinksMidSlash = YES
+OpenSearch.LoginNoun = YES
+OpenSearch.LoginVerb = YES
+OpenSearch.LogoutNoun = YES
+OpenSearch.LogoutVerb = YES
+OpenSearch.MergeConflicts = YES
+OpenSearch.OxfordComma = YES
+OpenSearch.PassiveVoice = NO
+OpenSearch.Please = YES
+OpenSearch.Range = YES
+OpenSearch.Repetition = YES
+OpenSearch.RolloverNoun = YES
+OpenSearch.RolloverVerb = YES
+OpenSearch.SetupNoun = YES
+OpenSearch.SetupVerb = YES
+OpenSearch.SignatureV4 = YES
+OpenSearch.Simple = YES
+OpenSearch.SpacingPunctuation = YES
+OpenSearch.SpacingSlash = YES
+OpenSearch.SpacingWords = YES
+OpenSearch.Spelling = YES
+OpenSearch.StackedHeadings = YES
+OpenSearch.SubstitutionsError = YES
+OpenSearch.SubstitutionsSuggestion = YES
+OpenSearch.TableHeadings = YES
+OpenSearch.TimeoutNoun = YES
+OpenSearch.TimeoutVerb = YES
+OpenSearch.UnitsNames = YES
+OpenSearch.UnitsSpacing = YES
+OpenSearch.Version = YES
\ No newline at end of file