From 1ef7928b75ec03ea9a09010597947a10f1d5ac8e Mon Sep 17 00:00:00 2001 From: Sanchayan Maity Date: Mon, 8 Apr 2024 19:27:28 +0530 Subject: [PATCH] vale: Update styles --- .../.config/vale/styles/Google/GenderBias.yml | 76 ++++++----- vale/.config/vale/styles/Google/Headings.yml | 1 + .../vale/styles/Microsoft/Accessibility.yml | 11 +- .../.config/vale/styles/Microsoft/Adverbs.yml | 4 +- .../vale/styles/Microsoft/ComplexWords.yml | 120 ------------------ .../vale/styles/Microsoft/FirstPerson.yml | 4 +- .../vale/styles/Microsoft/GenderBias.yml | 4 - vale/.config/vale/styles/Microsoft/Terms.yml | 21 +-- .../vale/styles/Microsoft/URLFormat.yml | 7 +- .../vale/styles/Microsoft/Wordiness.yml | 13 +- 10 files changed, 73 insertions(+), 188 deletions(-) delete mode 100644 vale/.config/vale/styles/Microsoft/ComplexWords.yml diff --git a/vale/.config/vale/styles/Google/GenderBias.yml b/vale/.config/vale/styles/Google/GenderBias.yml index 9e70190..36f5a3f 100644 --- a/vale/.config/vale/styles/Google/GenderBias.yml +++ b/vale/.config/vale/styles/Google/GenderBias.yml @@ -1,47 +1,43 @@ 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 swap: - (?:alumna|alumnus): graduate - (?:alumnae|alumni): graduates - air(?:m[ae]n|wom[ae]n): pilot(s) - 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) - fisher(?:m[ae]n|wom[ae]n): fisher(s) - fresh(?:m[ae]n|wom[ae]n): first-year student(s) - 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 - oneupmanship: upstaging - poetess: poet - police(?:m[ae]n|wom[ae]n): police officer(s) - repair(?:m[ae]n|wom[ae]n): technician(s) - sales(?:m[ae]n|wom[ae]n): salesperson or sales people - service(?:m[ae]n|wom[ae]n): soldier(s) - steward(?:ess)?: flight attendant - tribes(?:m[ae]n|wom[ae]n): tribe member(s) - waitress: waiter - woman doctor: doctor - woman scientist[s]?: scientist(s) - work(?:m[ae]n|wom[ae]n): worker(s) + (?:alumna|alumnus): graduate + (?:alumnae|alumni): graduates + air(?:m[ae]n|wom[ae]n): pilot(s) + anchor(?:m[ae]n|wom[ae]n): anchor(s) + authoress: author + camera(?:m[ae]n|wom[ae]n): camera operator(s) + 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) + fisher(?:m[ae]n|wom[ae]n): fisher(s) + fresh(?:m[ae]n|wom[ae]n): first-year student(s) + garbage(?:m[ae]n|wom[ae]n): waste collector(s) + lady lawyer: lawyer + ladylike: courteous + mail(?:m[ae]n|wom[ae]n): mail carriers + man and wife: husband and wife + man enough: strong enough + mankind: human kind|humanity + manmade: manufactured + manpower: personnel + middle(?:m[ae]n|wom[ae]n): intermediary + news(?:m[ae]n|wom[ae]n): journalist(s) + ombuds(?:man|woman): ombuds + oneupmanship: upstaging + poetess: poet + police(?:m[ae]n|wom[ae]n): police officer(s) + repair(?:m[ae]n|wom[ae]n): technician(s) + sales(?:m[ae]n|wom[ae]n): salesperson or sales people + service(?:m[ae]n|wom[ae]n): soldier(s) + steward(?:ess)?: flight attendant + tribes(?:m[ae]n|wom[ae]n): tribe member(s) + waitress: waiter + woman doctor: doctor + woman scientist[s]?: scientist(s) + work(?:m[ae]n|wom[ae]n): worker(s) diff --git a/vale/.config/vale/styles/Google/Headings.yml b/vale/.config/vale/styles/Google/Headings.yml index e34d001..c8d5be2 100644 --- a/vale/.config/vale/styles/Google/Headings.yml +++ b/vale/.config/vale/styles/Google/Headings.yml @@ -26,3 +26,4 @@ exceptions: - Visual - VS - Windows + - JSON diff --git a/vale/.config/vale/styles/Microsoft/Accessibility.yml b/vale/.config/vale/styles/Microsoft/Accessibility.yml index 05bf927..f5f4829 100644 --- a/vale/.config/vale/styles/Microsoft/Accessibility.yml +++ b/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 diff --git a/vale/.config/vale/styles/Microsoft/Adverbs.yml b/vale/.config/vale/styles/Microsoft/Adverbs.yml index 07d98d8..5619f99 100644 --- a/vale/.config/vale/styles/Microsoft/Adverbs.yml +++ b/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 diff --git a/vale/.config/vale/styles/Microsoft/ComplexWords.yml b/vale/.config/vale/styles/Microsoft/ComplexWords.yml deleted file mode 100644 index 65b7a34..0000000 --- a/vale/.config/vale/styles/Microsoft/ComplexWords.yml +++ /dev/null @@ -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 diff --git a/vale/.config/vale/styles/Microsoft/FirstPerson.yml b/vale/.config/vale/styles/Microsoft/FirstPerson.yml index 77761af..f58dea3 100644 --- a/vale/.config/vale/styles/Microsoft/FirstPerson.yml +++ b/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 diff --git a/vale/.config/vale/styles/Microsoft/GenderBias.yml b/vale/.config/vale/styles/Microsoft/GenderBias.yml index a7f4888..fc987b9 100644 --- a/vale/.config/vale/styles/Microsoft/GenderBias.yml +++ 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 diff --git a/vale/.config/vale/styles/Microsoft/Terms.yml b/vale/.config/vale/styles/Microsoft/Terms.yml index 7708900..65fca10 100644 --- a/vale/.config/vale/styles/Microsoft/Terms.yml +++ b/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 - '(?:drive C:|drive C>|C: drive)': drive C - '(?:internet bot|web robot)s?': bot(s) - '(?:microsoft cloud|the cloud)': cloud - '(?:mobile|smart) ?phone': phone - '24/7': every day - 'audio(?:-| )book': audiobook - 'back(?:-| )light': backlight - 'chat ?bots?': chatbot(s) + "(?:agent|virtual assistant|intelligent personal assistant)": personal digital assistant + "(?:assembler|machine language)": assembly language + "(?:drive C:|drive C>|C: drive)": drive C + "(?:internet bot|web robot)s?": bot(s) + "(?:microsoft cloud|the cloud)": cloud + "(?:mobile|smart) ?phone": phone + "24/7": every day + "audio(?:-| )book": audiobook + "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 diff --git a/vale/.config/vale/styles/Microsoft/URLFormat.yml b/vale/.config/vale/styles/Microsoft/URLFormat.yml index 82e702f..4e24aa5 100644 --- a/vale/.config/vale/styles/Microsoft/URLFormat.yml +++ b/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 - diff --git a/vale/.config/vale/styles/Microsoft/Wordiness.yml b/vale/.config/vale/styles/Microsoft/Wordiness.yml index 9facc10..3d008d1 100644 --- a/vale/.config/vale/styles/Microsoft/Wordiness.yml +++ b/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