Prefer refactoring to suppression. When a suppression is unavoidable, include a short reason that explains why the exception is narrow.
Biome suppression:
// biome-ignore complexity.useMaxParams: Adapter mirrors the upstream API.
Oxlint suppression:
// oxlint-disable-next-line complexity -- Generated branch table.
df12 plugin suppression:
// oxlint-disable-next-line df12/require-public-jsdoc -- Legacy API is documented elsewhere.