Skip to content

Z511: EXCESSIVE_SENTENCE_LENGTH

  • Severity: Error

    Penalty: 0.0 points | Category: general

  • Remediation & Opt-In

    Auto-Fixable: No | Opt-In: No

Description

A prose sentence exceeds the configured maximum word count threshold (default: 40 words).

Extremely long sentences reduce reader comprehension, increase cognitive load, and hurt technical documentation readability.

How to Fix

  1. Break the sentence into two or more shorter sentences using punctuation (., ;).
  2. Use bullet points or lists to structure complex multi-part statements.

Configuration

You can configure the maximum allowed sentence length in .zenzic.toml:

max_sentence_length = 35

Suppression

To suppress this warning for a specific sentence, add an inline comment directive above the paragraph:

<!-- zenzic:ignore:Z511 -->

Reference

See the Finding Codes Index for finding code details.