Common Word Substitutions Rule

This rule enforces proper word usage by identifying commonly misused or non-standard words and suggesting their correct alternatives. It helps maintain professional and precise language by catching incorrect word forms, malapropisms, and redundant or unnecessarily complex terms.

The motivation behind this rule is to improve writing clarity and professionalism. Many of the words it catches are either:

  • Nonstandard variations of correct words (like "analyzation" instead of "analysis")
  • Common mistakes or malapropisms (like "affrontery" instead of "effrontery")
  • Unnecessarily complex words that have simpler alternatives (like "minimalize" instead of "minimize")
  • Redundant or incorrect constructions (like "irregardless" instead of "regardless")

Examples:

  • ❌ "The analyzation of the data was complete."
    ✅ "The analysis of the data was complete."

  • ❌ "She spoke thusly to the crowd."
    ✅ "She spoke thus to the crowd."

  • ❌ "Irregardless of the outcome..."
    ✅ "Regardless of the outcome..."

  • ❌ "We need to minimalize the impact."
    ✅ "We need to minimize the impact."

All violations are marked as errors and the rule will suggest the correct alternative(s) in its error message. The rule is case-insensitive, meaning it will catch these issues regardless of capitalization.

Rule Source

This rule comes from: https://github.com/mesosphere/dcos-docs-site

Rule Definition

extends: substitution
message: "Consider using '%s' instead of '%s'."
ignorecase: true
level: error
action:
  name: replace
swap:
  affrontery: effrontery
  analyzation: analysis
  annoyment: annoyance
  confirmant: confirmand
  confirmants: confirmands
  conversate: converse
  crained: cranded
  discomforture: discomfort|discomfiture
  dispersement: disbursement|dispersal
  doubtlessly: doubtless|undoubtedly
  forebearance: forbearance
  improprietous: improper
  inclimate: inclement
  inimicable: inimical
  irregardless: regardless
  minimalize: minimize
  minimalized: minimized
  minimalizes: minimizes
  minimalizing: minimizing
  optimalize: optimize
  paralyzation: paralysis
  pettifogger: pettifog
  proprietous: proper
  relative inexpense: relatively low price|affordability
  seldomly: seldom
  thusly: thus
  uncategorically: categorically
  undoubtably: undoubtedly|indubitably
  unequivocable: unequivocal
  unmercilessly: mercilessly
  unrelentlessly: unrelentingly|relentlessly