Merge pull request opensearch-project#1810 from kolchfa-aws/style-upd…

…ate-2

Add a sigv4 rule and more words to style workflow

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

@@ -2,4 +2,9 @@ extends: capitalization
 message: "'%s' is a heading and should be in sentence case."
 level: error
 scope: heading
-match: $sentence
+match: $sentence
+threshold: 1
+indicators:
+  - ":"
+exceptions:
+  - k    # ignores lowercase k-NN

.github/vale/styles/OpenSearch/SignatureV4.yml

@@ -0,0 +1,10 @@
+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

.github/vale/styles/OpenSearch/SubstitutionsError.yml

@@ -10,9 +10,13 @@ swap:
   'data set': dataset
   'for information on': for information about
   'for more information on': for more information about
+  'geo bounds': geobounds
+  '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

.github/vale/styles/OpenSearch/TableHeadings.yml

@@ -3,3 +3,5 @@ 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

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

@@ -2,6 +2,7 @@ Alerting plugin
 Anomaly Detection plugin
 Asynchronous Search plugin
 Cross-Cluster Replication plugin
+Crypto plugin
 Maps plugin
 Notebooks plugin
 Notifications plugin

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

@@ -105,6 +105,7 @@ Okta
 Open Distro
 OpenID Connect
 OpenSearch
+OpenSearch Benchmark
 OpenSearch Dashboards
 OpenSearch Project
 OpenSearch Service
@@ -143,7 +144,6 @@ Searchium
 Searchium.ai
 Sease
 Serverless
-SigV4 
 Simple Schema for Observability
 SnappyFlow
 SquareShift

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

@@ -4,7 +4,7 @@
 [Aa]utopopulate
 [Aa]utoscaler?
 [Bb]ackoff
-[Bb]ackport
+[Bb]ackport(s|ing)?
 [Bb]ackpressure
 [Bb]asemap
 [Bb]igram
@@ -16,6 +16,7 @@ Boolean
 [Cc]onfig
 [Cc]ron
 [Cc]ybersecurity
+[Dd]ashboarding
 [Dd]atagram
 [Dd]eallocate
 [Dd]eduplication
@@ -53,12 +54,14 @@ k-NN
 [Kk]eystore
 kibibyte
 mebibyte
+[Ll]earnings
 [Ll]emmatization
 Levenshtein
 [Ll]inestring
 [Ll]ookups?
 [Ll]ossy
 [Ll]owercases?d?
+[Mm]acrobenchmarks?
 [Mm]isorder
 [Mm]odularization
 [Mm]ultifield
@@ -88,19 +91,22 @@ pebibyte
 [Rr]eindex
 [Rr]eingest
 [Rr]epo
-[Rr]erank
+[Rr]erank(er|ed|ing)?
 [Rr]erankers?
 [Rr]ewriters?
+[Rr]ollout
 [Rr]ollup
 [Rr]unbooks?
 [Ss]erverless
+[Ss]harding
 [Ss]ignificand
 stdout
 [Ss]ubaggregation
 [Ss]ubcalculation
 [Ss]ubcommands?
 [Ss]ubfield
 [Ss]ubquery
+[Ss]ubstrings?
 [Ss]ubtag
 [Ss]ubtree
 [Ss]ubvector

.vale.ini

@@ -48,6 +48,7 @@ OpenSearch.RolloverNoun = YES
 OpenSearch.RolloverVerb = YES
 OpenSearch.SetupNoun = YES
 OpenSearch.SetupVerb = YES
+OpenSearch.SignatureV4 = YES
 OpenSearch.SpacingPunctuation = YES
 OpenSearch.SpacingSlash = YES
 OpenSearch.SpacingWords = YES

_posts/2023-07-06-optimize-opensearch-index-shard-size.markdown

@@ -106,4 +106,6 @@ Optimizing the number and size of shards in your index can help you get the best
 
 If you prefer to learn about this topic in video format instead of a blog post, check out this YouTube video: [OpenSearch - How to change the number of primary and replica shard(s) of an index](https://www.youtube.com/watch?v=xadv93LlbY4). This blog post is based on this GitHub repository: [OpenSearch_Read_Only_Index](https://github.com/ev2900/OpenSearch_Read_Only_Index)
 
-If you are using Amazon OpenSearch Service (that is, the managed service), the AWS documentation also has information on index shard sizes. The [operational best practices shard strategy](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/bp.html#bp-sharding-strategy) section includes recommendations specific to the AWS managed service.
+If you are using Amazon OpenSearch Service (that is, the managed service), the AWS documentation also has information on index shard sizes. The [operational best practices shard strategy](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/bp.html#bp-sharding-strategy) section includes recommendations specific to the AWS managed service.
+
+Backports to our repo