lucid-lint 0.2.5

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
48
49
50

# `structure.deeply-nested-lists`

## What it flags

Bulleted list items nested beyond a reasonable depth. A deeply nested list forces the reader to reconstruct a complex mental hierarchy — horizontal indentation stops being a positional cue and becomes noise. Four levels of indent are too many for readers with attentional difficulties to track.

## At a glance

| | |
|---|---|
| **Category** | `structure` |
| **Default severity** | `warning` |
| **Default weight** | `1` |
| **Languages** | language-agnostic |
| **Source** | [`src/rules/deeply_nested_lists.rs`](https://github.com/bastien-gallay/lucid-lint/blob/main/src/rules/deeply_nested_lists.rs) |

## Detection

Parse Markdown via `pulldown-cmark`; extract list items with their indentation level; flag items deeper than `max_depth`. Deterministic, no false positives.

## Parameters

| Key | Type | `dev-doc` | `public` | `falc` |
|---|---|---|---|---|
| `max_depth` | `int` | 4 | 3 | 2 |

## Example

Under `public` (max depth 3):

```markdown
- Level 1
  - Level 2
    - Level 3
      - Level 4    ← flagged
```

## Diagnostic message

Includes repair guidance: flatten the structure, split into multiple lists, or promote sub-items to subsections with headings.

## Suppression

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

## References

- [WCAG 2.1](../references.md#wcag-2-1)

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