Z107: CIRCULAR_ANCHOR

Severity: error Penalty: 1.0 point Category: structural Auto-fixable: No

Rationale

This rule is emitted when an anchor link's visible text label slugifies to the exact same string as its own fragment identifier, creating a redundant self-referential jump link that points to its current position.

How to Fix

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

Bad (Triggers Z107)

<!-- BAD: Link text label matches fragment slug -->
[#installation](#installation)

Good (Resolves Z107)

<!-- GOOD: Descriptive text label explaining the jump destination -->
[Jump to Installation Guide](#installation)

Configuration

# Can be ignored for didactic tutorial pages via directory_policies
[governance.directory_policies]
"docs/tutorials/examples/z1xx-links/**" = ["Z107"]

Reference

See the Finding Codes Index for finding code details.