Skip to main content

Z602-i18n-parity — I18N_PARITY

Z-Code: Z602 I18N_PARITY · Engine: standalone · Exit: 1

zenzic check links
docs/en/guide.md
✘[Z602]Missing IT translation: expected mirror at docs/it/guide.md (relative to base guide.md)
'zenzic check --help' for options.
exit 1

The Fixture​

The fixture lives in examples/z602-i18n-parity/ in the Zenzic repository. It contains documents demonstrating the Z602 violation.

Running the Example​

# Clone the Zenzic repository — no extra installation required
cd examples/z602-i18n-parity
uvx zenzic check all

Expected output:

standalone - 3 files (3 docs, 0 assets) - 0.0s - 108 files/s

docs/en/guide.md  x  [Z602]  Missing IT translation: expected mirror at 
/home/pythonwoods/dev/PythonSandbox/zenzic/examples/z602-i18n-parity/docs/it/gui
de.md (relative to base guide.md)

────────────────────────────────────────────────────────────────────────────────

Summary:  x 1 error  ! 0 warnings  i 0 info  - 1 file with findings

FAILED: Hard errors detected. Exit code 1 is mandatory.
Refer to https://zenzic.dev/docs/reference/finding-codes for remediation · Try 
'zenzic check --help' for options.
[ Suppression Audit: 0/30 (inline: 0, per-file: 0)

Exit code: 1

Interpreting the Output​

The Z602 finding indicates a I18N_PARITY issue.

This error or warning is raised by Zenzic when there is a translation parity issue. A page exists in the base language (e.g., English) but lacks its corresponding translated mirror file in a target language (e.g., Italian), or the metadata/frontmatter parameters do not match. In this specific example:

  • Scan Type: I18N Parity Guard
  • Severity: Warning / Governance Gate
  • Impact: Translation parity violations indicate incomplete localization work, affecting governance score calculations.

Resolve the Issue​

Exit code 1. Create the missing translation file inside the target locale folder, maintaining the exact path structure of the base locale.

See Also​