British to American English Spelling Conversion

This rule enforces consistent use of American English spellings throughout the content by identifying and flagging British English spelling variants. It's important for maintaining consistency in documentation, especially for organizations that follow American English style guidelines. This consistency helps reduce confusion and ensures a professional, unified voice across all content.

The rule works through a substitution system that identifies British English spellings and suggests their American English counterparts. It is case-insensitive and provides specific error messages with the correct American spelling.

Examples:

  • ❌ "The centre of the diagram..." → ✅ "The center of the diagram..."
  • ❌ "We need to analyse the results..." → ✅ "We need to analyze the results..."
  • ❌ "The colour scheme shows..." → ✅ "The color scheme shows..."
  • ❌ "This behaviour is expected..." → ✅ "This behavior is expected..."
  • ❌ "The programme will start..." → ✅ "The program will start..."

The rule covers a comprehensive list of common British-to-American spelling variations, including differences in word endings (-our/-or, -ise/-ize, -re/-er), and other specific word variations (e.g., 'grey/gray', 'defence/defense').

Rule Source

This rule comes from: https://github.com/mui/material-ui

Rule Definition

extends: substitution
message: Use the US spelling '%s' instead of the British '%s'
link: https://www.notion.so/mui-org/Writing-style-guide-2a957a4168a54d47b14bae026d06a24b?pvs=4#25755bff02764565b954631236ab183d
level: error
ignorecase: true
swap:
  aeon: eon
  aeroplane: airplane
  ageing: aging
  aluminium: aluminum
  anaemia: anemia
  anaesthesia: anesthesia
  analyse: analyze
  annexe: annex
  apologise: apologize
  authorisation: authorization
  authorise: authorize
  authorised: authorized
  authorising: authorizing
  behaviour: behavior
  bellow: below
  busses: buses
  calibre: caliber
  categorise: categorize
  categorised: categorized
  categorises: categorizes
  categorising: categorizing
  centre: center
  cheque: check
  civilisation: civilization
  civilise: civilize
  colour: color
  cosy: cozy
  cypher: cipher
  defence: defense
  dependant: dependent
  distil: distill
  draught: draft
  encyclopaedia: encyclopedia
  enquiry: inquiry
  enrol: enroll
  enrolment: enrollment
  enthral: enthrall
  favourite: favorite
  fibre: fiber
  fillet: filet
  flavour: flavor
  fulfil: fulfill
  furore: furor
  gaol: jail
  grey: gray
  honour: honor
  humour: humor
  initialled: initialed
  initialling: initialing
  instil: instill
  jewellery: jewelry
  labelled: labeled
  labelling: labeling
  labour: labor
  libellous: libelous
  licence: license
  likeable: likable
  liveable: livable
  lustre: luster
  manoeuvre: maneuver
  marvellous: marvelous
  meagre: meager
  metre: meter
  modelling: modeling
  moustache: mustache
  neighbour: neighbor
  normalise: normalize
  offence: offense
  optimise: optimize
  optimised: optimized
  optimising: optimizing
  organise: organize
  orientated: oriented
  paralyse: paralyze
  plough: plow
  pretence: pretense
  programme: program
  pyjamas: pajamas
  rateable: ratable
  realise: realize
  recognise: recognize
  reconnoitre: reconnoiter
  rumour: rumor
  sabre: saber
  saleable: salable
  saltpetre: saltpeter
  sceptic: skeptic
  sepulchre: sepulcher
  signalling: signaling
  sizeable: sizable
  skilful: skillful
  smoulder: smolder
  sombre: somber
  speciality: specialty
  spectre: specter
  splendour: splendor
  standardise: standardize
  standardised: standardized
  sulphur: sulfur
  theatre: theater
  travelled: traveled
  traveller: traveler
  travelling: traveling
  unshakeable: unshakable
  wilful: willful
  yoghurt: yogurt