home blog portfolio Ian Fisher

A Vale plugin for proofreading English prose

22 May 2025 Subscribe
linguistics 6

garner-vale is a collection of stylistic suggestions and corrections for English prose, written as a plugin for the command-line tool Vale. I spent more than 20 hours reading all 983 pages of the fourth edition of Garner's Modern English Usage (by Bryan A. Garner) and hand-coding as many entries as practicable.1

garner-vale is, to my knowledge, the most comprehensive plugin ever written for Vale. It has over 200 distinct rules covering more than 3,000 words and phrases, among them more than 100 tricky plural forms, almost 1,900 corrections for misspellings and malapropisms, more than 500 'needless variant' terms, and dozens of commonly-confused pairs of words. It recognizes all inflected forms of verbs and nouns (obtain, obtains, obtaining, obtained) and produces suggestions that respect the original form (obtainget, obtainsgets, obtaininggetting, obtainedgot).

You can find instructions for installation at https://github.com/iafisher/garner-vale. Comments, suggestions, and corrections are welcome at https://github.com/iafisher/garner-vale/issues or by email.

A note on Garner: Samuel Johnson wrote that "to make dictionaries is dull work," and I can testify that to read them is hardly more edifying. But even after trawling2 through every entry from "a" to "zwieback",3 I cannot praise Garner's Modern English Usage enough. It is a masterly4 achievement of lexicography that sparkles with erudition and wit, and anyone who is serious about writing in English should get their hands on a copy. ∎


  1. 'practicable', not 'practical' – see p. 716. 

  2. 'trawling', not 'trolling' – see p. 918. 

  3. A type of sweetened German bread commonly misspelled 'zweiback'. 

  4. 'masterly', not 'masterful' – see p. 583.