Skip to content

Z106: CIRCULAR_LINK

  • Severity: Error


    Penalty: 0.0 points | Category: general

  • Remediation & Opt-In


    Auto-Fixable: No | Opt-In: No


Rationale

This rule is an informational telemetry signal emitted when two or more documentation pages form a direct circular navigation loop through relative links.

While not fatal to static site rendering, cyclic navigation loops can confuse readers and degrade automated search engine crawler traversal.


How to Fix

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

  • Failing Pattern (Triggers Z106)


    docs/example.md
    <!-- page-a.md links to page-b.md -->
    See [Section B](page-b.md).
    
    <!-- page-b.md links back to page-a.md -->
    Return to [Section A](page-a.md).
    
  • Passing Pattern (Resolves Z106)


    docs/example.md
    <!-- Restructure navigation to form a linear/hierarchical reading path -->
    See [Section B](page-b.md).
    

Configuration

.zenzic.toml
# Informational diagnostic; no point deduction subtracted from DQS

Reference

See the Finding Codes Index for finding code details.