Skip to content Aller au contenu

Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Référence des règles

lucid-lint livre 25 règles en v0.2 (17 reprises de v0.1, 8 ajouts v0.2). Chaque règle dispose d’une page dédiée avec sa catégorie, sa sévérité, son poids par défaut, ses seuils par profil, des exemples, et les consignes de neutralisation.

La référence compacte RULES.md reste la vue d’ensemble en un seul fichier, conservée à la racine du dépôt. Les sources académiques et normatives derrière chaque règle sont consolidées sur la page Références.

Traduction FR — complète. Les 25 règles ont chacune leur page dédiée en français (jalon F25 sur la feuille de route).

Catégories

Chaque règle appartient à exactement une des cinq catégories fixes. La taxonomie fait autorité — le modèle de score compose les sous-scores par catégorie dans le score global X / max.

L’identifiant en kebab-case (par ex. structure.sentence-too-long) est le contrat stable utilisé partout : option CLI, sortie JSON, clé de configuration, citation dans les docs. Le libellé FR ci-dessous est un repère humain ; il n’aliase jamais l’identifiant.

Structure

RègleLibellé
structure.sentence-too-longPhrase trop longue
structure.paragraph-too-longParagraphe trop long
structure.heading-jumpSaut de niveau de titre
structure.deeply-nested-listsListes trop imbriquées
structure.excessive-commasVirgules en excès
structure.long-enumerationÉnumération trop longue
structure.deep-subordinationSubordination profonde
structure.line-length-wideLignes trop larges
structure.mixed-numeric-formatFormats numériques mixtes

Rythme

RègleLibellé
rhythm.consecutive-long-sentencesPhrases longues consécutives
rhythm.repetitive-connectorsRépétition de connecteurs

Lexique

RègleLibellé
lexicon.low-lexical-diversityDiversité lexicale faible
lexicon.excessive-nominalizationNominalisations en excès
lexicon.unexplained-abbreviationAbréviations non explicitées
lexicon.weasel-wordsMots évasifs
lexicon.jargon-undefinedJargon non défini
lexicon.all-caps-shoutingMajuscules criardes
lexicon.redundant-intensifierIntensificateurs redondants
lexicon.consonant-clusterAmas consonantiques

Syntaxe

RègleLibellé
syntax.passive-voiceVoix passive
syntax.unclear-antecedentAntécédent flou
syntax.nested-negationNégations imbriquées
syntax.conditional-stackingEmpilement de conditions
syntax.dense-punctuation-burstRafale de ponctuation

Lisibilité

RègleLibellé
readability.scoreScore de lisibilité

Source d’autorité. La catégorie de chaque règle est déterminée par Category::for_rule dans src/types.rs. Les tableaux ci-dessus reflètent cette fonction. Un test de couverture (tests/rule_docs_coverage.rs) tient les pages par règle, le helper de catégorie et les poids du score synchronisés.

Niveaux de sévérité

NiveauSensEffet
infoSignal à connaître, pas un défautRemonté ; ne fait pas échouer la CI
warningProblème de qualité à corrigerRemonté ; peut faire échouer la CI selon --min-score
errorRéservé pour v0.3+Non émis en v0.2

Proposer une règle

Voir Contributing pour la checklist d’ajout de règle — toute nouvelle règle doit être livrée avec une page dans cette section.