Skip to content

Z411: DEAD_END_NODE

Severity: warning Penalty: 5.0 points Category: structural Auto-fixable: No

Description

The document has no outgoing links and forms a structural dead end in the documentation graph.

A Dead End (Z411) occurs when a Markdown/MDX page does not link to any other resources. In a well-structured documentation graph, every page should ideally guide the user to further reading, related topics, or back to a main index. A page with zero outgoing links strands the reader.

Terminal assets like images, CSS files, and PDFs are excluded from this rule.

How to Fix

Add relevant outgoing links to the document to connect it to the rest of the documentation graph:

  1. Link to related concepts or further reading.
  2. Link to a parent or index page to provide a path back.

Suppression

If the document is intentionally designed as a dead end (for example, a terminal legal disclaimer or an auto-generated changelog with no internal references), you can suppress this warning using an inline directive at the top of the file:

<!-- zenzic:ignore:Z411 -->

Alternatively, you can ignore the file globally using directory policies in .zenzic.toml:

[directory_policies.legal]
match = "legal/**"
ignore = ["Z411"]

Reference

See the Finding Codes Index for finding code details.