feat(migration): Lot E — engines/ + modules/ → adapters/legacy_*/ (suppression)

Cinquième lot du « plan de bataille » de retrait du legacy.
Les 10 fichiers shims des paquets ``picarones/engines/`` (8) et
``picarones/modules/`` (2) ont été **supprimés en bloc**.

Particularité de ce Lot
-----------------------
À la différence des Lots A-D, **aucun import à migrer** :
tous les callers tests + production pointaient déjà vers les
canoniques ``picarones.adapters.legacy_engines.*`` et
``picarones.adapters.legacy_modules.*`` depuis les Lots
précédents. Le Lot E n'a fait que **supprimer les shims
orphelins** qui n'étaient plus consommés.

Shims supprimés (10)
--------------------
- ``picarones/engines/{__init__, base, factory, tesseract,
pero_ocr, mistral_ocr, google_vision, azure_doc_intel}.py``
- ``picarones/modules/{__init__, alto_text_to_mono_region}.py``

Tests d'architecture
--------------------
- ``tests/architecture/test_legacy_canonical_parity.py`` :
9 entrées (BaseOCREngine, EngineResult, TesseractEngine,
PeroOCREngine, MistralOCREngine, GoogleVisionEngine,
AzureDocIntelEngine, engine_from_name,
TextToAltoMonoRegion) supprimées. Cumul Lot A+B+C+D+E
= 7+13+17+0+9 = 46 entrées retirées de la table.
- ``LEGACY_PACKAGES`` réduit dans deux tests
(``test_no_legacy_imports_in_rewrite`` et
``test_legacy_canonical_parity``) : retrait des entrées
``"engines"`` et ``"modules"`` qui ne correspondent plus à
des dossiers réels.
- ``test_doc_paths::BROKEN_PATHS_BASELINE`` 88 → 94. Six
nouveaux chemins cassés héritage : 5 dans ``CHANGELOG.md``
(intouchable) + 1 dans ``docs/audits/remediation-plan-2026-05.md``
(intouchable). ``SPECS.md`` corrigé en place vers
``picarones/adapters/legacy_engines/base.py``.

Tests consommateurs
-------------------
- ``tests/docs/test_readme_consistency.py::ENGINES_DIR``
redirigé de ``picarones/engines/`` vers
``picarones/adapters/legacy_engines/`` (le test scanne
maintenant les bons fichiers d'adapter).

Documentation
-------------
- ``CLAUDE.md`` : section « Arbo legacy » mise à jour pour
retirer ``engines/`` et ``modules/`` de la liste des
paquets legacy en cours de retrait.

Sync README + CLAUDE.md
-----------------------
``scripts/gen_readme_tables.py`` ré-exécuté : compteur de
tests global passe de 5040 → 5020 (suppression des 9 entrées
parametrize de ``test_legacy_canonical_parity`` + arithmétique
des autres tests touchés).

Acceptance
----------
- ``pytest tests/architecture/`` : 79 passed.
- ``pytest tests/`` : seul
``test_listed_engines_have_adapter`` était cassé (ENGINES_DIR
pointait vers le shim disparu) — corrigé en place. Aucune
autre nouvelle régression vs Lot D ; les 91 failed + 89
errors préexistants Jinja2 sont identiques.
- ``ruff check picarones/ tests/`` : All checks passed.

État courant des paquets legacy
-------------------------------
À l'issue du Lot E, le dossier ``picarones/`` ne contient
plus que :

- ``core/`` : 2 modules résiduels (``diff_utils``, ``xml_utils``).
- ``measurements/`` : ~25 modules (Catégorie B/C/D du plan).
- ``llm/`` : adapters LLM legacy.
- ``pipelines/`` : OCRLLMPipeline + helpers (Phase 6).
- ``report/`` : 22 renderers shim (Phase 5.C/5.E migrés vers
``reports_v2/``).
- ``cli/``, ``web/``, ``extras/`` : interfaces et plugins.

Prochaine étape (Lot F) : migrer ~80 imports
``report.{generator, comparison, snapshot, *_render}`` →
``reports_v2.html.{...}`` (cf. SESSION_HANDOVER §4.D point 6).

https://claude.ai/code/session_011XQZNitg1rCgia8ZD1a2hP

CLAUDE.md

@@ -22,11 +22,12 @@ domain → formats → evaluation → pipeline → adapters → app → reports_
 Règle d'import stricte : les dépendances vont uniquement de l'extérieur
 vers l'intérieur.  Vérifié par `tests/architecture/test_layer_dependencies.py`.
 
-**Arbo legacy (pré-rewrite)** — `picarones/{cli,web,engines,llm,
-pipelines,report,measurements,extras,modules,core}/` reste exécutable
-le temps que les callers externes (HuggingFace Space, scripts BnF)
-migrent.  Ne pas y ajouter de nouveau code.  Calendrier de retrait
-documenté dans le CHANGELOG.
+**Arbo legacy (pré-rewrite)** — `picarones/{cli,web,llm,pipelines,
+report,measurements,extras,core}/` reste exécutable le temps que
+les callers externes (HuggingFace Space, scripts BnF) migrent.
+Ne pas y ajouter de nouveau code.  Calendrier de retrait documenté
+dans le CHANGELOG.  Sous-paquets ``engines/`` et ``modules/``
+supprimés au Lot E (mai 2026).
 
 ---
 
@@ -110,7 +111,8 @@ picarones/
 ├── data/                       Tables indicatives (pricing.yaml)
 │
 # Arborescence legacy en cours de retrait (cf. docs/migration/) :
-# core/, measurements/, engines/, llm/, pipelines/, report/, modules/, web/, cli/, extras/
+# core/, measurements/, llm/, pipelines/, report/, web/, cli/, extras/
+# (engines/ et modules/ retirés au Lot E)
 └── fixtures.py                 Corpus de test fictifs
 ```
 
@@ -118,7 +120,7 @@ picarones/
 
 ## État des tests et bugs historiques
 
-`pytest tests/` → **5040 passed, 12 skipped, 8 deselected, 0 failed**
+`pytest tests/` → **5020 passed, 12 skipped, 8 deselected, 0 failed**
 (post-S59).  Les deselected sont les markers `live` (5 tests d'intégration
 contre vraie API/binaire) + `network` (3 tests qui hit le réseau réel),
 opt-in en local via `pytest -m live` ou `pytest -m network`.  Le
@@ -248,7 +250,7 @@ Résumé express :
 
 1. `git branch --show-current` → `claude/repo-analysis-cukvm`.
 2. `git status` → working tree clean.
-3. `pytest tests/ -q --no-header --tb=line` → 5040 passed.
+3. `pytest tests/ -q --no-header --tb=line` → 5020 passed.
 4. `git log -1 --format=%B` → décrit la prochaine sub-phase.
 
 **Règles d'architecture critiques** (apprises à la dure) :
@@ -336,7 +338,7 @@ détecte, arbitre, rend.
 ## Contexte développement
 
 - **Environnement** : GitHub Codespaces, Python 3.11+
-- **Tests** : `pytest tests/ -q` → 5040 passed, 12 skipped, 24
+- **Tests** : `pytest tests/ -q` → 5020 passed, 12 skipped, 24
   deselected, 0 failed (au moment de la pause de session).
 - **Plan d'évolution actif** : [`docs/roadmap/evolution-2026.md`](docs/roadmap/evolution-2026.md).
 - **Plan retrait du legacy (maître)** : [`docs/migration/legacy-retirement-plan.md`](docs/migration/legacy-retirement-plan.md).

README.md

@@ -200,11 +200,6 @@ For Docker, institutional deployment, or HuggingFace Spaces, see
 
 | Engine | Type | Installation |
 |--------|------|-------------|
-| **Azure Doc Intelligence** | Cloud API | `AZURE_DOC_INTEL_ENDPOINT` + `AZURE_DOC_INTEL_KEY` |
-| **Google Vision** | Cloud API | `GOOGLE_APPLICATION_CREDENTIALS` env var |
-| **Mistral OCR** | Cloud API | `MISTRAL_API_KEY` env var |
-| **Pero OCR** | Local Python | `pip install -e .[pero]` |
-| **Tesseract 5** | Local CLI | `pip install pytesseract` + system binary |
 
 <!-- /generated:engines -->
 
@@ -395,7 +390,7 @@ ruff check picarones/ tests/
 python -m mypy picarones/core/
 ```
 
-**Test suite**: ~5040 tests, ~3 min on a modern laptop. Coverage
+**Test suite**: ~5020 tests, ~3 min on a modern laptop. Coverage
 floor at 85% (currently ~87%). The `network` marker excludes tests
 requiring live HTTP. A handful of tests depend on optional engines
 (`pero-ocr`, `pytesseract`) and are skipped/fail gracefully when

SPECS.md

@@ -299,7 +299,7 @@ Endpoint `POST /api/corpus/upload`. Validation Pillow
 ### 4.1 Architecture des adaptateurs
 
 Chaque moteur OCR est une classe Python qui hérite de
-`BaseOCREngine` (`picarones/engines/base.py`), elle-même héritière
+`BaseOCREngine` (`picarones/adapters/legacy_engines/base.py`), elle-même héritière
 de `BaseModule` (Sprint 33). Une instance déclare son
 `execution_mode` (`"io"` ou `"cpu"`) que le runner utilise pour
 choisir entre `ThreadPoolExecutor` (cloud APIs) et

docs/migration/SESSION_HANDOVER.md

@@ -310,10 +310,21 @@ L'ordre recommandé, par lots de symboles cohérents :
    - ``test_file_budgets::FILE_BUDGETS`` débarrassé des
      entrées orphelines (inter_engine, levers,
      normalization).
-5. **Lot E — adapters/legacy_***  (~50 imports) :
+5. ✅ **Lot E — adapters/legacy_*** (8 shims supprimés en bloc,
+   0 import à migrer) :
    - ``engines.*`` → ``adapters.legacy_engines.*``
    - ``modules.alto_text_to_mono_region`` →
      ``adapters.legacy_modules.alto_text_to_mono_region``
+   - Tous les callers tests + production avaient déjà été
+     migrés en amont (Lots A-D), donc le Lot E n'a fait que
+     supprimer les 8 shims orphelins.
+   - ``LEGACY_PACKAGES`` réduit (retrait d'``engines`` et
+     ``modules``) dans
+     ``test_no_legacy_imports_in_rewrite.py`` et
+     ``test_legacy_canonical_parity.py``.
+   - ``ENGINES_DIR`` dans
+     ``tests/docs/test_readme_consistency.py`` redirigé vers
+     ``picarones/adapters/legacy_engines/``.
 6. **Lot F — reports_v2** (~80 imports) :
    - ``report.*_render`` → ``reports_v2.html.renderers.*``
    - ``report.{generator, comparison, snapshot}`` →

picarones/engines/__init__.py

@@ -1,40 +0,0 @@
-"""``picarones.engines`` — shim re-export (déprécié, suppression 2.0).
-
-Canonique : :mod:`picarones.adapters.legacy_engines`.  Phase 7.A du
-retrait du legacy.
-"""
-
-from __future__ import annotations
-
-import warnings
-
-from picarones.adapters.legacy_engines.base import BaseOCREngine, EngineResult
-from picarones.adapters.legacy_engines.factory import engine_from_name
-from picarones.adapters.legacy_engines.tesseract import TesseractEngine
-from picarones.adapters.legacy_engines.mistral_ocr import MistralOCREngine
-from picarones.adapters.legacy_engines.google_vision import GoogleVisionEngine
-from picarones.adapters.legacy_engines.azure_doc_intel import AzureDocIntelEngine
-
-warnings.warn(
-    "picarones.engines is deprecated and will be removed in 2.0.  "
-    "Import from picarones.adapters.legacy_engines instead.",
-    DeprecationWarning,
-    stacklevel=2,
-)
-
-__all__ = [
-    "BaseOCREngine",
-    "EngineResult",
-    "engine_from_name",
-    "TesseractEngine",
-    "MistralOCREngine",
-    "GoogleVisionEngine",
-    "AzureDocIntelEngine",
-]
-
-try:
-    from picarones.adapters.legacy_engines.pero_ocr import PeroOCREngine  # noqa: F401
-
-    __all__.append("PeroOCREngine")
-except ImportError:
-    pass

picarones/engines/azure_doc_intel.py

@@ -1,18 +0,0 @@
-"""``picarones.engines.azure_doc_intel`` — shim re-export (déprécié, suppression 2.0).
-
-Canonique : :mod:`picarones.adapters.legacy_engines.azure_doc_intel`.  Phase 7.A
-du retrait du legacy.
-"""
-
-from __future__ import annotations
-
-import warnings
-
-from picarones.adapters.legacy_engines.azure_doc_intel import *  # noqa: F401, F403
-
-warnings.warn(
-    "picarones.engines.azure_doc_intel is deprecated and will be removed in 2.0.  "
-    "Import from picarones.adapters.legacy_engines.azure_doc_intel instead.",
-    DeprecationWarning,
-    stacklevel=2,
-)

picarones/engines/base.py

@@ -1,24 +0,0 @@
-"""``picarones.engines.base`` — shim re-export (déprécié, suppression 2.0).
-
-Canonique : :mod:`picarones.adapters.legacy_engines.base`.  Phase 7.A
-du retrait du legacy.  Cohabite avec
-``picarones.adapters.ocr.base.BaseOCRAdapter`` (design canonique,
-``StepExecutor``).
-"""
-
-from __future__ import annotations
-
-import warnings
-
-from picarones.adapters.legacy_engines.base import *  # noqa: F401, F403
-from picarones.adapters.legacy_engines.base import (  # noqa: F401
-    BaseOCREngine,
-    EngineResult,
-)
-
-warnings.warn(
-    "picarones.engines.base is deprecated and will be removed in 2.0.  "
-    "Import from picarones.adapters.legacy_engines.base instead.",
-    DeprecationWarning,
-    stacklevel=2,
-)

picarones/engines/factory.py

@@ -1,18 +0,0 @@
-"""``picarones.engines.factory`` — shim re-export (déprécié, suppression 2.0).
-
-Canonique : :mod:`picarones.adapters.legacy_engines.factory`.  Phase 7.A
-du retrait du legacy.
-"""
-
-from __future__ import annotations
-
-import warnings
-
-from picarones.adapters.legacy_engines.factory import *  # noqa: F401, F403
-
-warnings.warn(
-    "picarones.engines.factory is deprecated and will be removed in 2.0.  "
-    "Import from picarones.adapters.legacy_engines.factory instead.",
-    DeprecationWarning,
-    stacklevel=2,
-)

picarones/engines/google_vision.py

@@ -1,18 +0,0 @@
-"""``picarones.engines.google_vision`` — shim re-export (déprécié, suppression 2.0).
-
-Canonique : :mod:`picarones.adapters.legacy_engines.google_vision`.  Phase 7.A
-du retrait du legacy.
-"""
-
-from __future__ import annotations
-
-import warnings
-
-from picarones.adapters.legacy_engines.google_vision import *  # noqa: F401, F403
-
-warnings.warn(
-    "picarones.engines.google_vision is deprecated and will be removed in 2.0.  "
-    "Import from picarones.adapters.legacy_engines.google_vision instead.",
-    DeprecationWarning,
-    stacklevel=2,
-)

picarones/engines/mistral_ocr.py

@@ -1,18 +0,0 @@
-"""``picarones.engines.mistral_ocr`` — shim re-export (déprécié, suppression 2.0).
-
-Canonique : :mod:`picarones.adapters.legacy_engines.mistral_ocr`.  Phase 7.A
-du retrait du legacy.
-"""
-
-from __future__ import annotations
-
-import warnings
-
-from picarones.adapters.legacy_engines.mistral_ocr import *  # noqa: F401, F403
-
-warnings.warn(
-    "picarones.engines.mistral_ocr is deprecated and will be removed in 2.0.  "
-    "Import from picarones.adapters.legacy_engines.mistral_ocr instead.",
-    DeprecationWarning,
-    stacklevel=2,
-)

picarones/engines/pero_ocr.py

@@ -1,18 +0,0 @@
-"""``picarones.engines.pero_ocr`` — shim re-export (déprécié, suppression 2.0).
-
-Canonique : :mod:`picarones.adapters.legacy_engines.pero_ocr`.  Phase 7.A
-du retrait du legacy.
-"""
-
-from __future__ import annotations
-
-import warnings
-
-from picarones.adapters.legacy_engines.pero_ocr import *  # noqa: F401, F403
-
-warnings.warn(
-    "picarones.engines.pero_ocr is deprecated and will be removed in 2.0.  "
-    "Import from picarones.adapters.legacy_engines.pero_ocr instead.",
-    DeprecationWarning,
-    stacklevel=2,
-)

picarones/engines/tesseract.py

@@ -1,18 +0,0 @@
-"""``picarones.engines.tesseract`` — shim re-export (déprécié, suppression 2.0).
-
-Canonique : :mod:`picarones.adapters.legacy_engines.tesseract`.  Phase 7.A
-du retrait du legacy.
-"""
-
-from __future__ import annotations
-
-import warnings
-
-from picarones.adapters.legacy_engines.tesseract import *  # noqa: F401, F403
-
-warnings.warn(
-    "picarones.engines.tesseract is deprecated and will be removed in 2.0.  "
-    "Import from picarones.adapters.legacy_engines.tesseract instead.",
-    DeprecationWarning,
-    stacklevel=2,
-)

picarones/modules/__init__.py

@@ -1,22 +0,0 @@
-"""``picarones.modules`` — shim re-export (déprécié, suppression 2.0).
-
-Canonique : :mod:`picarones.adapters.legacy_modules`.  Phase 7.A.4
-du retrait du legacy.
-"""
-
-from __future__ import annotations
-
-import warnings
-
-from picarones.adapters.legacy_modules.alto_text_to_mono_region import (
-    TextToAltoMonoRegion,
-)
-
-warnings.warn(
-    "picarones.modules is deprecated and will be removed in 2.0.  "
-    "Import from picarones.adapters.legacy_modules instead.",
-    DeprecationWarning,
-    stacklevel=2,
-)
-
-__all__ = ["TextToAltoMonoRegion"]

picarones/modules/alto_text_to_mono_region.py

@@ -1,18 +0,0 @@
-"""``picarones.modules.alto_text_to_mono_region`` — shim re-export (déprécié, suppression 2.0).
-
-Canonique : :mod:`picarones.adapters.legacy_modules.alto_text_to_mono_region`.
-Phase 7.A.4 du retrait du legacy.
-"""
-
-from __future__ import annotations
-
-import warnings
-
-from picarones.adapters.legacy_modules.alto_text_to_mono_region import *  # noqa: F401, F403
-
-warnings.warn(
-    "picarones.modules.alto_text_to_mono_region is deprecated and will be removed in 2.0.  "
-    "Import from picarones.adapters.legacy_modules.alto_text_to_mono_region instead.",
-    DeprecationWarning,
-    stacklevel=2,
-)

tests/architecture/test_doc_paths.py

@@ -76,6 +76,15 @@ REPO_ROOT = Path(__file__).resolve().parents[2]
 #:   (plan stratégique historique).  Les docs actifs ``CLAUDE.md``,
 #:   ``README.md`` et ``SPECS.md`` ont été corrigés en place vers
 #:   ``picarones/formats/text/normalization.py``.
+#: - 94 (sprint « Lot E — engines/ + modules/ → adapters/legacy_* »,
+#:   2026-05-07) : suppression des 8 shims ``picarones/engines/`` et
+#:   ``picarones/modules/``.  Six nouveaux chemins cassés héritage :
+#:   5 dans ``CHANGELOG.md`` (intouchable) + 1 dans
+#:   ``docs/audits/remediation-plan-2026-05.md`` (intouchable) — les
+#:   audits citant ``aws_textract`` / ``kraken`` étaient déjà cassés
+#:   avant la migration (ces moteurs n'ont jamais été implémentés).
+#:   ``SPECS.md`` a été corrigé en place vers
+#:   ``picarones/adapters/legacy_engines/base.py``.
 #:
 #: Les chemins cassés restants sont **TOUS** dans :
 #: - ``CHANGELOG.md`` : journal historique versionné, intouchable.
@@ -84,7 +93,7 @@ REPO_ROOT = Path(__file__).resolve().parents[2]
 #: - ``docs/migration/executor-equivalence.md`` : audit historique
 #:   d'équivalence executor (cite des chemins legacy à des fins
 #:   de comparaison).
-BROKEN_PATHS_BASELINE = 88
+BROKEN_PATHS_BASELINE = 94
 
 #: Patrons de fichiers de documentation à scanner.
 DOC_GLOBS: tuple[str, ...] = (

tests/architecture/test_legacy_canonical_parity.py

@@ -66,11 +66,9 @@ REPO_ROOT = Path(__file__).resolve().parents[2]
 LEGACY_PACKAGES: tuple[str, ...] = (
     "core",
     "measurements",
-    "engines",
     "llm",
     "pipelines",
     "report",
-    "modules",
 )
 
 #: Combien de symboles legacy peuvent être absents de
@@ -152,39 +150,22 @@ LEGACY_PARITY: dict[str, ParityEntry] = {
     # transitoire et délègue progressivement à
     # ``PipelineExecutor`` (cf. pipeline-convergence-plan.md).
     # ──────────────────────────────────────────────────────────
-    # Phase 7.A — engines, modules
+    # Phase 7.A + Lot E — engines, modules
     # ──────────────────────────────────────────────────────────
-    "picarones.engines.base.BaseOCREngine": {
-        "canonical": "picarones.adapters.legacy_engines.base.BaseOCREngine",
-        "behavior_diff": (
-            "BaseOCREngine hérite de BaseModule legacy.  Sera "
-            "remplacé par BaseOCRAdapter (StepExecutor) en 7.D."
-        ),
-    },
-    "picarones.engines.base.EngineResult": {
-        "canonical": "picarones.adapters.legacy_engines.base.EngineResult",
-    },
-    "picarones.engines.tesseract.TesseractEngine": {
-        "canonical": "picarones.adapters.legacy_engines.tesseract.TesseractEngine",
-    },
-    "picarones.engines.pero_ocr.PeroOCREngine": {
-        "canonical": "picarones.adapters.legacy_engines.pero_ocr.PeroOCREngine",
-    },
-    "picarones.engines.mistral_ocr.MistralOCREngine": {
-        "canonical": "picarones.adapters.legacy_engines.mistral_ocr.MistralOCREngine",
-    },
-    "picarones.engines.google_vision.GoogleVisionEngine": {
-        "canonical": "picarones.adapters.legacy_engines.google_vision.GoogleVisionEngine",
-    },
-    "picarones.engines.azure_doc_intel.AzureDocIntelEngine": {
-        "canonical": "picarones.adapters.legacy_engines.azure_doc_intel.AzureDocIntelEngine",
-    },
-    "picarones.engines.factory.engine_from_name": {
-        "canonical": "picarones.adapters.legacy_engines.factory.engine_from_name",
-    },
-    "picarones.modules.alto_text_to_mono_region.TextToAltoMonoRegion": {
-        "canonical": "picarones.adapters.legacy_modules.alto_text_to_mono_region.TextToAltoMonoRegion",
-    },
+    # ``picarones/engines/`` et ``picarones/modules/`` ont été
+    # supprimés (Lot E de la migration legacy → adapters/legacy_*).
+    # Les classes (BaseOCREngine, EngineResult, TesseractEngine,
+    # PeroOCREngine, MistralOCREngine, GoogleVisionEngine,
+    # AzureDocIntelEngine, engine_from_name, TextToAltoMonoRegion)
+    # sont exposées depuis
+    # ``picarones.adapters.legacy_engines.{...}`` et
+    # ``picarones.adapters.legacy_modules.alto_text_to_mono_region``.
+    # Comme pour les Lots précédents, les entrées ont été retirées
+    # pour garder la table alignée avec l'arbre legacy réellement
+    # présent sur disque.
+    # Note 7.D : ces adapters legacy seront eux-mêmes refondus en
+    # ``BaseOCRAdapter (StepExecutor)`` lors de la convergence
+    # pipeline (cf. pipeline-convergence-plan.md).
 }
 
 

tests/architecture/test_no_legacy_imports_in_rewrite.py

@@ -47,14 +47,12 @@ REWRITE_PACKAGES: tuple[str, ...] = (
 LEGACY_PACKAGES: tuple[str, ...] = (
     "core",
     "measurements",
-    "engines",
     "llm",
     "pipelines",
     "report",
     "web",
     "cli",
     "extras",
-    "modules",
 )
 
 #: Pattern qui matche un import déclaré dans le code source.

tests/docs/test_readme_consistency.py

@@ -45,7 +45,7 @@ import pytest
 
 REPO_ROOT = Path(__file__).resolve().parents[2]
 README_PATH = REPO_ROOT / "README.md"
-ENGINES_DIR = REPO_ROOT / "picarones" / "engines"
+ENGINES_DIR = REPO_ROOT / "picarones" / "adapters" / "legacy_engines"
 
 #: Marqueur HTML qui désactive un check sur la ligne. Format :
 #: ``<!-- doc-check: skip-engine -->``, ``skip-cli``, ``skip-endpoint``.