GraSs: A Taxonomy of Grammar Smells

Organisation
global problems

Navigation
problems with navigating through the grammar

Structure
harmful relationships among grammar components

Convention
violations of visual policies

Notation
metalanguage-related

Parsing
parsing techniques related smells

Duplication
the same fragment is repeated

Echo
same rule occurs twice or more

Clone
same right hand side occurs twice or more

Foldable
nonterminal's right hand side is not unique

Common
common subexpressions

Permuted
permutations in commutative combinators

Lookalike
near-clones

Permuted Edit!

Clones modulo permutations (e.g., A | B vs B | A) are confusing: if the choice used in the notation is commutative, they are just Clones, otherwise if the choice is ordered, having both A / B and B / A within the same grammar is even more confusing for everyone.

The GraSs taxonomy is a joint effort maintained by Dr. Vadim Zaytsev a.k.a. @grammarware. Page last updated in March 2021.