Z619: MAX_DOCUMENT_COMPLEXITY¶
-
Severity: Error
Penalty: 0.0 points | Category:
general -
Remediation & Opt-In
Auto-Fixable: No | Opt-In: No
Description¶
A document's structural complexity score exceeds the maximum allowed threshold configured in [policies].max_document_complexity.
Document complexity measures cognitive load based on prose word count, heading depth, and link density. Excessively complex pages are difficult for readers to digest and maintain.
How to Fix¶
Refactor or split the document into smaller, modular topics linked together through a table of contents or conceptual guides.
Configuration¶
Set the complexity ceiling in .zenzic.toml:
Suppression¶
Suppress with an inline comment:
Reference¶
See the Finding Codes Index for finding code details.