Z302: DEAD_DEF

Severity: warning Penalty: 1.0 point Category: navigation Auto-fixable: No

Rationale¶

This rule is emitted when a reference link definition [ref-id]: URL is declared in a Markdown document but is never consumed by any reference link in that file. Unused link definitions clutter source files.

How to Fix¶

Inspect the flagged location in the Markdown file and update the content or configuration:

Bad (Triggers Z302)¶

<!-- BAD: Definition declared at bottom but never referenced in prose -->
[unused-link]: https://example.com/api

Good (Resolves Z302)¶

<!-- GOOD: Reference the link definition in prose, or delete the line -->
Check the [API Docs][unused-link].

[unused-link]: https://example.com/api

Configuration¶

# Evaluated during reference auditing pass

Reference¶

See the Finding Codes Index for finding code details.