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

lexicon.jargon-undefined

What it flags

Domain-specific terms used without definition. Jargon is contextual: acceptable among specialists, exclusionary otherwise. Like acronyms, jargon creates reading interruptions for the non-specialist; unlike acronyms, these are content words, not uppercase sequences.

References. US Plain Language, FALC, WCAG 2.1 SC 3.1.3 (Unusual Words).

At a glance

Categorylexicon
Default severitywarning
Default weight1
LanguagesEN · FR (separate lists per language and domain)
Sourcesrc/rules/jargon_undefined.rs

Detection

  1. Maintain multiple jargon lists per domain (tech, legal, medical, admin).
  2. User activates the relevant lists via profile.
  3. Flag each occurrence of a listed term.

Profile activation

ProfileLists active
dev-docnone (developers understand their own jargon)
publictech, legal, medical, admin
falctech, legal, medical, admin, strict mode

Configuration

In v0.2, the active lists are set by the profile and are not yet user-overridable from lucid-lint.toml. Per-rule TOML overrides — adding custom domain terms, silencing specific entries, or activating a non-default list combination — are tracked as F126 on the roadmap.

Default starter lists (community contributions welcome)

  • Tech: idempotent, orthogonal, deterministic, polymorphic, serialization, deserialization, synchronous, asynchronous, concurrency, thread-safe, side-effect, referential transparency, memoization, currying, hoisting, closure, monad, immutable, stateless, refactoring
  • Legal (mostly FR): apériteur, clause résolutoire, force majeure, cessation de paiement, préjudice subi, onéreux, nonobstant, préalablement, susmentionné, infra, supra, ad hoc, de facto, in fine, subséquemment
  • Medical: anamnèse, étiologie, pathognomonique, iatrogène, nosocomial, décompensation, récidive, rémission, syndromique
  • Admin (mostly FR): attributaire, solliciter, diligenter, instruction du dossier, pièces justificatives, circulaire, délibération, arrêté préfectoral, transmission des pièces, ayant droit

Suppression

See Suppressing diagnostics.

See also

References

See References for the full bibliography.