Z105: ABSOLUTE_PATH

Severity: error Penalty: 2.0 points Category: structural Auto-fixable: No

Rationale

This rule is triggered when internal links or asset paths use absolute filesystem paths or root-relative paths (e.g. /docs/setup.md or C:\project\docs\setup.md).

Absolute paths break portability across different operating systems, CI build runners, and subpath web deployments.

How to Fix

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

Bad (Triggers Z105)

<!-- BAD: Absolute root-relative path specifier -->
Read the [Setup Guide](/docs/how-to/setup.md).

Good (Resolves Z105)

<!-- GOOD: Portable relative path calculated from source file -->
Read the [Setup Guide](../how-to/setup.md).

Configuration

# Enforced across workspace when strict mode is active
strict = true

Reference

See the Finding Codes Index for finding code details.