Add new rules and guidance for describing/comparing numerical values

Author: sarahlwelton

ValeStyles/Couchbase/Values.yml

@@ -0,0 +1,8 @@
+extends: existence
+message: When comparing or describing a value, use 'greater' or 'less'.
+level: warning
+link: https://docs.couchbase.com/styleguide/values.html
+
+tokens:
+  - '\b(?:above|below|higher|lower)\b\s+\d+(?:\.\d+)?'
+  - '\b(?:above|below|higher|lower)\b(?:\s+the|\s+than)?(?:\s+\w+){0,5}?\s+(?:limit|threshold|maximum|minimum|cap|ceiling|floor|boundary|cutoff)\b'

styleguide/modules/ROOT/nav.adoc

@@ -8,6 +8,7 @@
 ** xref:articles.adoc[]
 ** xref:capitalization.adoc[]
 ** xref:contractions.adoc[]
+** xref:values.adoc[]
 ** xref:directional-language.adoc[]
 ** xref:less-fewer.adoc[]
 ** xref:only.adoc[]

styleguide/modules/ROOT/pages/values.adoc

@@ -0,0 +1,12 @@
+= Describing or Comparing Values
+
+When describing or comparing numerical values in the documentation, use `greater than` or `less than`.
+
+Do not use: 
+
+* higher
+* lower
+* above
+* below
+
+If Vale flags an instance of `higher`, `lower`, `above`, or `below` that you feel is valid, let the tooling team know so an exception can be added to the rule.