Missing suppression reasons
What a missing-suppression-reason finding of fallow dead-code means, why it matters and how to fix it.
What it reports
Suppression comment omits a required reason.
Suppress a finding explains how fallow finds it.
Why it matters
Without a reason, a reviewer cannot tell if the suppression is a decision or a shortcut. Later, nobody can check if the reason still holds, so the suppression stays forever.
Example
// fallow-ignore-next-line unused-export appears without a reason after the token, while requireSuppressionReason is on.
Fix
Add a concise reason after the suppression token, or remove the suppression if the issue is no longer intentional.
Facts
| Fact | Value |
|---|---|
| Issue type | missing-suppression-reason |
| Rule id in SARIF output | fallow/missing-suppression-reason |
| Command | fallow dead-code |
| Default severity | off |
Config key in rules | require-suppression-reason |
| Filter option | --stale-suppressions |
Fixable with fallow fix | No |
| Opt-in | Yes |