lucid-lint 0.2.4

A cognitive accessibility linter for prose. Bilingual EN/FR. CI-native.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# `structure.paragraph-too-long`

## What it flags

Paragraphs that overrun either a sentence-count or a word-count threshold. A paragraph is a visual reprise unit: long paragraphs dilute the reprise point for readers who interrupt often. Both metrics are checked so that a short-but-dense paragraph (one 80-word sentence) is still caught — [`structure.sentence-too-long`](./sentence-too-long.md) covers the complementary case.

## At a glance

| | |
|---|---|
| **Category** | `structure` |
| **Default severity** | `warning` |
| **Default weight** | `2` |
| **Languages** | EN · FR (identical detection) |
| **Source** | [`src/rules/paragraph_too_long.rs`](https://github.com/bastien-gallay/lucid-lint/blob/main/src/rules/paragraph_too_long.rs) |

## Detection

Split on blank lines (Markdown paragraph convention). Count sentences and words per paragraph. Flag paragraphs exceeding *either* threshold.

## Parameters

| Key | Type | `dev-doc` | `public` | `falc` |
|---|---|---|---|---|
| `max_sentences` | `int` | 7 | 5 | 3 |
| `max_words` | `int` | 150 | 100 | 60 |

## Examples

A paragraph of eight medium sentences under the `public` profile will fire on `max_sentences`. A paragraph containing a single 120-word sentence will fire on `max_words` (and also on [`structure.sentence-too-long`](./sentence-too-long.md)).

## Suppression

See [Suppressing diagnostics](../guide/suppression.md).

## See also

- [`structure.sentence-too-long`](./sentence-too-long.md)
- [`rhythm.consecutive-long-sentences`](./consecutive-long-sentences.md)

## References

- [Sweller (1988)](../references.md#sweller-1988)
- [Graesser et al. (2004)](../references.md#graesser-2004)
- [CAN-ASC-3.1:2025](../references.md#can-asc-3-1-2025)

See [References](../references.md) for the full bibliography.