Merge branch 'develop' into warehouse-doc-updates

Author: markzegarelli

.github/.vale.ini

@@ -0,0 +1,7 @@
+StylesPath = .github/styles
+
+Vocab = Docs
+
+[*.md]
+BasedOnStyles = segment
+TokenIgnores = ({% .* %})

.github/Vocab/Docs/accept.txt

@@ -0,0 +1,59 @@
+allowlist
+Appboy
+blocklist
+boolean
+CloudFront
+Cocoapods
+Gradle
+HTTP
+http
+HTTPS
+https
+Javadoc
+Javadocs
+Javascript
+Kameleoon
+Kissmetrics
+Littledata
+Middleware
+middleware
+Mixpanel
+Okta
+performant
+Preact
+Shopify
+Totango
+Twilio
+Vero
+WebKit
+Wootric
+Zendesk
+iOS
+ios
+Dev
+ga
+(?:G|g)tag
+(?:P|p)ageviews?\b
+(?:R|r)emarketing
+Doubleclick
+(?:C|c)annonical
+(?:U|u)rls?\b
+Optimizely
+Omnichannel
+namespace
+upsert
+viewability
+measurability
+Lightbox
+gmail
+(?:P|p)endo
+(?:K|k)laviyo
+(?:U|u)nmaps?\b
+(?:U|u)nlinks?\b
+(?:P|p)ostgres
+Smartly
+Hubspot
+Friendbuy
+Chargebee
+(?:L|l)ookback
+Subnet

.github/Vocab/Docs/reject.txt

@@ -0,0 +1,6 @@
+functionality
+e.g.
+i.e.
+signup
+setup
+login

.github/Vocab/Marketing/accept.txt

@@ -0,0 +1,12 @@
+extends: substitution
+message: "Use '%s' instead of '%s'."
+# link: https://docs.microsoft.com/en-us/style-guide/word-choice/use-us-spelling-avoid-non-english-words
+ignorecase: true
+level: error
+nonword: true
+
+action:
+  name: replace
+swap:
+  '\b(?:eg|e\.g\.)[\s,]': for example
+  '\b(?:ie|i\.e\.)[\s,]': that is, for example

.github/Vocab/Marketing/reject.txt

@@ -0,0 +1,6 @@
+extends: substitution
+message: "Please use '%s' instead of '%s'."
+link: https://docs.microsoft.com/en-us/style-guide/punctuation/exclamation-points
+level: warning
+swap:
+    '\w!\s': '\.'

.github/styles/segment/Latin.yml

@@ -0,0 +1,6 @@
+extends: existence
+message: "Write meaningful link text."
+link: https://docs.microsoft.com/en-us/style-guide/urls-web-addresses
+level: warning
+raw:
+  - '\[?here\]\('

.github/styles/segment/exclamation.yml

@@ -0,0 +1,7 @@
+extends: existence
+message: 'Link to Segment docs "%s" must be relative.'
+level: warning
+scope: raw
+raw:
+  - '\[.+\]\(https://(www.)?segment.com/docs.*\)'
+

.github/styles/segment/links.yml

@@ -0,0 +1,15 @@
+extends: substitution
+message:  Please use '%s' instead of '%s'
+level: error
+ignorecase: true
+swap:
+  blacklist: blocklist
+  whitelist: allowlist
+  utilize: use
+  utilizes: uses
+  utilizing: using
+  leverage: use
+  leverages: uses
+  leveraging: using
+  via: through, or using
+  drop in: enter