Vadim Zaytsev aka @grammarware

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

Underuse
inferior substitutes are used instead of an available feature
Overspec
the same constraint specified through several means
Priorities
not present or circular
Singleton
trivial choice, sequence or conjunction
Combo
double modifier creates an ambiguity
Chant
comments cover up bad code
Deprecated
the use of a feature that is no longer welcome
Exotic
too idiosyncratic notational features decrease portability

Overspec Edit!

In many notations, there are various ways to achieve the same effect, and information in those should not be duplicated or contradictory, since it only confuses grammar engineers and leads to grammars with very subtle bugs. The simplest example of Overspec is something like !"a" & ("b" | "c"), where the choice between "b" and "c" is preceded by a negative conjunctive clause saying that they at the same must not be "a". Naturally, this cannot happen in either case, so the clause is either disposable or erroneous.


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