Merge pull request cockroachdb#3227 from cockroachdb/more-vale-rules

More vale rules

Author: Jesse Seldess

ci/vale/CockroachDB/Contractions.yml

@@ -1,5 +1,6 @@
 extends: substitution
 message: Use '%s' instead of '%s'
+link: https://github.com/cockroachdb/docs/blob/master/STYLE.md#language-and-tone
 ignorecase: false
 level: warning
 swap:

ci/vale/CockroachDB/HeadingsCase.yml

@@ -1,5 +1,6 @@
 extends: capitalization
 message: "'%s' should be in sentence case"
+link: https://github.com/cockroachdb/docs/blob/master/STYLE.md#capitalization-and-punctuation
 level: warning
 scope: heading
 match: $sentence

ci/vale/CockroachDB/HeadingsPunctuation.yml

@@ -1,6 +1,7 @@
 extends: existence
-message: Do not use end punctuation (%s) in headings
+message: Do not use '%s' at the end of headings
+link: https://github.com/cockroachdb/docs/blob/master/STYLE.md#capitalization-and-punctuation
 scope: heading
 level: warning
 raw:
-  - '(?:[^a-zA-Z])$'
+  - '(?:\:|\.)$'

ci/vale/CockroachDB/Hyperbolic.yml

@@ -0,0 +1,10 @@
+extends: existence
+message: Consider removing '%s'
+link: https://github.com/cockroachdb/docs/blob/master/STYLE.md#language-and-tone
+ignorecase: true
+level: warning
+tokens:
+  - simple
+  - just
+  - easily
+  - actually

ci/vale/CockroachDB/OxfordComma.yml

@@ -1,5 +1,6 @@
 extends: existence
-message: 'Use the Oxford comma in a list of three or more items.'
+message: Use the Oxford comma in a list of three or more items
+link: https://github.com/cockroachdb/docs/blob/master/STYLE.md#capitalization-and-punctuation
 level: warning
 tokens:
   - '(?:[^,]+,){1,}\s\w+\sand'

ci/vale/CockroachDB/Terminology.yml

@@ -0,0 +1,10 @@
+extends: substitution
+message: Prefer '%s' over '%s'
+ignorecase: false
+level: warning
+swap:
+  cockroachdb: CockroachDB
+  raft: Raft
+  admin UI: Admin UI
+  admin ui: Admin UI
+  ui: UI