Skip to content

Z410: UNREACHABLE_GRAPH_NODE

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

Description

The document is isolated and unreachable from the navigation entry points of the documentation graph.

A document is considered an orphan graph node if it is discovered in the filesystem by Zenzic, but no valid path of links connects it to the root configuration (e.g., the nav section in MkDocs or Zensical).

While Z402 (ORPHAN_PAGE) checks if a page is listed in the top-level navigation, Z410 performs a deep topological Breadth-First Search (BFS) to ensure the document can be reached by a user clicking through links starting from the navigation entry points.

How to Fix

To resolve this issue, you must integrate the document into the reachable graph:

  1. Add a link to the document from another document that is already reachable.
  2. Add the document directly to the main navigation menu (mkdocs.yml or equivalent).

Suppression

If the document is intentionally isolated (for example, a standalone template or an internal include that is not meant to be browsed), you can suppress this warning using an inline directive at the top of the file:

<!-- zenzic:ignore:Z410 -->

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

[directory_policies.internal]
match = "internal/**"
ignore = ["Z410"]

Reference

See the Finding Codes Index for finding code details.