vale: Update styles

vale/.config/vale/styles/Google/GenderBias.yml

@@ -1,7 +1,7 @@
 extends: substitution
 message: "Consider using '%s' instead of '%s'."
-link: 'https://developers.google.com/style/inclusive-documentation'
 ignorecase: true
+link: "https://developers.google.com/style/inclusive-documentation"
 level: error
 action:
   name: replace
@@ -12,8 +12,6 @@ swap:
   anchor(?:m[ae]n|wom[ae]n): anchor(s)
   authoress: author
   camera(?:m[ae]n|wom[ae]n): camera operator(s)
-  chair(?:m[ae]n|wom[ae]n):    chair(s)
-  congress(?:m[ae]n|wom[ae]n): member(s) of congress
   door(?:m[ae]|wom[ae]n): concierge(s)
   draft(?:m[ae]n|wom[ae]n): drafter(s)
   fire(?:m[ae]n|wom[ae]n): firefighter(s)
@@ -22,14 +20,12 @@ swap:
   garbage(?:m[ae]n|wom[ae]n): waste collector(s)
   lady lawyer: lawyer
   ladylike: courteous
-  landlord:                    building manager
   mail(?:m[ae]n|wom[ae]n): mail carriers
   man and wife: husband and wife
   man enough: strong enough
-  mankind:                     human kind
+  mankind: human kind|humanity
   manmade: manufactured
   manpower: personnel
-  men and girls:               men and women
   middle(?:m[ae]n|wom[ae]n): intermediary
   news(?:m[ae]n|wom[ae]n): journalist(s)
   ombuds(?:man|woman): ombuds

vale/.config/vale/styles/Google/Headings.yml

@@ -26,3 +26,4 @@ exceptions:
   - Visual
   - VS
   - Windows
+  - JSON

vale/.config/vale/styles/Microsoft/Accessibility.yml

@@ -6,20 +6,25 @@ ignorecase: true
 tokens:
   - a victim of
   - able-bodied
-  - affected by
   - an epileptic
+  - birth defect
   - crippled
+  - differently abled
   - disabled
   - dumb
   - handicapped
   - handicaps
-  - healthy
+  - healthy person
+  - hearing-impaired
   - lame
   - maimed
+  - mentally handicapped
   - missing a limb
   - mute
-  - normal
+  - non-verbal
+  - normal person
   - sight-impaired
+  - slow learner
   - stricken with
   - suffers from
   - vision-impaired

vale/.config/vale/styles/Microsoft/Adverbs.yml

@@ -1,5 +1,5 @@
 extends: existence
-message: "Consider removing '%s'."
+message: "Remove '%s' if it's not important to the meaning of the statement."
 link: https://docs.microsoft.com/en-us/style-guide/word-choice/use-simple-words-concise-sentences
 ignorecase: true
 level: warning
@@ -54,6 +54,7 @@ tokens:
   - doubtfully
   - dreamily
   - easily
+  - effectively
   - elegantly
   - energetically
   - enormously
@@ -164,6 +165,7 @@ tokens:
   - quickly
   - quietly
   - quirkily
+  - quite
   - quizzically
   - randomly
   - rapidly

vale/.config/vale/styles/Microsoft/ComplexWords.yml

@@ -1,120 +0,0 @@
-extends: substitution
-message: "Consider using '%s' instead of '%s'."
-link: https://docs.microsoft.com/en-us/style-guide/word-choice/use-simple-words-concise-sentences
-ignorecase: true
-level: suggestion
-action:
-  name: replace
-swap:
-  "approximate(?:ly)?": about
-  abundance: plenty
-  accelerate: speed up
-  accentuate: stress
-  accompany: go with
-  accomplish: carry out|do
-  accorded: given
-  accordingly: so
-  accrue: add
-  accurate: right|exact
-  acquiesce: agree
-  acquire: get|buy
-  additional: more|extra
-  address: discuss
-  addressees: you
-  adjacent to: next to
-  adjustment: change
-  admissible: allowed
-  advantageous: helpful
-  advise: tell
-  aggregate: total
-  aircraft: plane
-  alleviate: ease
-  allocate: assign|divide
-  alternatively: or
-  alternatives: choices|options
-  ameliorate: improve
-  amend: change
-  anticipate: expect
-  apparent: clear|plain
-  ascertain: discover|find out
-  assistance: help
-  attain: meet
-  attempt: try
-  authorize: allow
-  belated: late
-  bestow: give
-  cease: stop|end
-  collaborate: work together
-  commence: begin
-  compensate: pay
-  component: part
-  comprise: form|include
-  concept: idea
-  concerning: about
-  confer: give|award
-  consequently: so
-  consolidate: merge
-  constitutes: forms
-  contains: has
-  convene: meet
-  demonstrate: show|prove
-  depart: leave
-  designate: choose
-  desire: want|wish
-  determine: decide|find
-  detrimental: bad|harmful
-  disclose: share|tell
-  discontinue: stop
-  disseminate: send|give
-  eliminate: end
-  elucidate: explain
-  employ: use
-  enclosed: inside|included
-  encounter: meet
-  endeavor: try
-  enumerate: count
-  equitable: fair
-  equivalent: equal
-  exclusively: only
-  expedite: hurry
-  facilitate: ease
-  females: women
-  finalize: complete|finish
-  frequently: often
-  identical: same
-  incorrect: wrong
-  indication: sign
-  initiate: start|begin
-  itemized: listed
-  jeopardize: risk
-  liaise: work with|partner with
-  maintain: keep|support
-  methodology: method
-  modify: change
-  monitor: check|watch
-  multiple: many
-  necessitate: cause
-  notify: tell
-  numerous: many
-  objective: aim|goal
-  obligate: bind|compel
-  optimum: best|most
-  permit: let
-  portion: part
-  possess: own
-  previous: earlier
-  previously: before
-  prioritize: rank
-  procure: buy
-  provide: give|offer
-  purchase: buy
-  relocate: move
-  solicit: request
-  state-of-the-art: latest
-  subsequent: later|next
-  substantial: large
-  sufficient: enough
-  terminate: end
-  transmit: send
-  utilization: use
-  utilize: use

vale/.config/vale/styles/Microsoft/FirstPerson.yml

@@ -5,8 +5,8 @@ ignorecase: true
 level: warning
 nonword: true
 tokens:
-  - (?:^|\s)I\s
+  - (?:^|\s)I(?=\s)
-  - (?:^|\s)I,\s
+  - (?:^|\s)I(?=,\s)
   - \bI'd\b
   - \bI'll\b
   - \bI'm\b

vale/.config/vale/styles/Microsoft/GenderBias.yml

@@ -11,8 +11,6 @@ swap:
   anchor(?:m[ae]n|wom[ae]n): anchor(s)
   authoress: author
   camera(?:m[ae]n|wom[ae]n): camera operator(s)
-  chair(?:m[ae]n|wom[ae]n): chair(s)
-  congress(?:m[ae]n|wom[ae]n): member(s) of congress
   door(?:m[ae]|wom[ae]n): concierge(s)
   draft(?:m[ae]n|wom[ae]n): drafter(s)
   fire(?:m[ae]n|wom[ae]n): firefighter(s)
@@ -21,14 +19,12 @@ swap:
   garbage(?:m[ae]n|wom[ae]n): waste collector(s)
   lady lawyer: lawyer
   ladylike: courteous
-  landlord: building manager
   mail(?:m[ae]n|wom[ae]n): mail carriers
   man and wife: husband and wife
   man enough: strong enough
   mankind: human kind
   manmade: manufactured
   manpower: personnel
-  men and girls: men and women
   middle(?:m[ae]n|wom[ae]n): intermediary
   news(?:m[ae]n|wom[ae]n): journalist(s)
   ombuds(?:man|woman): ombuds

vale/.config/vale/styles/Microsoft/Terms.yml

@@ -7,27 +7,28 @@ ignorecase: true
 action:
   name: replace
 swap:
-  '(?:agent|virtual assistant|intelligent personal assistant)': personal digital assistant
+  "(?:agent|virtual assistant|intelligent personal assistant)": personal digital assistant
-  '(?:drive C:|drive C>|C: drive)': drive C
+  "(?:assembler|machine language)": assembly language
-  '(?:internet bot|web robot)s?': bot(s)
+  "(?:drive C:|drive C>|C: drive)": drive C
-  '(?:microsoft cloud|the cloud)': cloud
+  "(?:internet bot|web robot)s?": bot(s)
-  '(?:mobile|smart) ?phone': phone
+  "(?:microsoft cloud|the cloud)": cloud
-  '24/7': every day
+  "(?:mobile|smart) ?phone": phone
-  'audio(?:-| )book': audiobook
+  "24/7": every day
-  'back(?:-| )light': backlight
+  "audio(?:-| )book": audiobook
-  'chat ?bots?': chatbot(s)
+  "back(?:-| )light": backlight
+  "chat ?bots?": chatbot(s)
   adaptor: adapter
   administrate: administer
   afterwards: afterward
   alphabetic: alphabetical
   alphanumerical: alphanumeric
+  an URL: a URL
   anti-aliasing: antialiasing
   anti-malware: antimalware
   anti-spyware: antispyware
   anti-virus: antivirus
   appendixes: appendices
   artificial intelligence: AI
-  '(?:assembler|machine language)': assembly language
   caap: CaaP
   conversation-as-a-platform: conversation as a platform
   eb: EB

vale/.config/vale/styles/Microsoft/URLFormat.yml

@@ -1,10 +1,9 @@
 extends: substitution
-message: "Use '%s' instead of '%s'."
+message: Use 'of' (not 'for') to describe the relationship of the word URL to a resource.
 ignorecase: true
-level: error
+link: https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/u/url
+level: suggestion
 action:
   name: replace
 swap:
   URL for: URL of
-  an URL: a URL
-

vale/.config/vale/styles/Microsoft/Wordiness.yml

@@ -2,20 +2,23 @@ extends: substitution
 message: "Consider using '%s' instead of '%s'."
 link: https://docs.microsoft.com/en-us/style-guide/word-choice/use-simple-words-concise-sentences
 ignorecase: true
-level: warning
+level: suggestion
 action:
   name: replace
 swap:
-  (?:give|gave) rise to: lead to
+  (?:extract|take away|eliminate): remove
+  (?:in order to|as a means to): to
+  (?:inform|let me know): tell
   (?:previous|prior) to: before
+  (?:utilize|make use of): use
   a (?:large)? majority of: most
   a (?:large)? number of: many
   a myriad of: myriad
   adversely impact: hurt
   all across: across
+  all of (?!a sudden|these): all
   all of a sudden: suddenly
   all of these: these
-  all of (?!a sudden|these): all
   all-time record: record
   almost all: most
   almost never: seldom
@@ -52,13 +55,14 @@ swap:
   continue on: continue
   despite the fact that: although
   disappear from sight: disappear
+  doomed to fail: doomed
   drag and drop: drag
   drag-and-drop: drag
-  doomed to fail: doomed
   due to the fact that: because
   during the period of: during
   during the time that: while
   emergency situation: emergency
+  establish connectivity: connect
   except when: unless
   excessive number: too many
   extend an invitation: invite
@@ -74,6 +78,7 @@ swap:
   in a careful manner: carefully
   in a thoughtful manner: thoughtfully
   in a timely manner: timely
+  in addition: also
   in an effort to: to
   in between: between
   in lieu of: instead of