Skip to content

docs(moteur): renvoyer à la doc du moteur au lieu de la recopier (dsoxlab#201) - #89

Merged
stephrobert merged 1 commit into
mainfrom
docs/moteur-par-lien
Nov 14, 2026
Merged

stephrobert merged 1 commit into
mainfrom
docs/moteur-par-lien

Conversation

@stephrobert

Copy link
Copy Markdown
Owner

Pourquoi

Les catalogues recopient la documentation du moteur dsoxlab, et cette copie dérive (dsoxlab#201). Le squelette de dsoxlab new catalog renvoie désormais au moteur par des liens (dsoxlab main 2663b6b). Cette PR aligne ce catalogue sur ce squelette.

Remplacé par un lien

  • README.md / README.fr.md, section « How it works / Comment ça marche ». Les sous-sections « contrat déclaratif » et « cycle de vie d'un lab » sont remplacées par la sous-section du squelette, « The engine, documented where it lives / Le moteur, documenté là où il vit ».
  • CONTRIBUTING.md / CONTRIBUTING.fr.md, « Anatomy of a lab ». L'arbre et ses conventions restent. Une phrase renvoie au guide de l'auteur et au contrat de dsoxlab.

Ce qui reste propre au catalogue

  • Les workflows rejoués en local (act) et le parcours : inchangés.
  • docs/conception.md n'est pas touché. L'inventaire le classe ambigu, et c'est à trancher.
  • Une entrée « Changed / Modifié » sous [Unreleased].

Mesure

validate-structure --json, joué avec le moteur de dsoxlab main : stale_doc = 0 avant comme après, ok: true, aucune autre anomalie.

Les hooks pre-commit ont tourné au commit.

🤖 Generated with Claude Code

…xlab#201)

Les sections du README qui recopiaient le contrat de dsoxlab et le cycle
de vie d'un lab sont remplacées par la section du squelette de
`dsoxlab new catalog` (main 2663b6b), qui renvoie à la documentation du
moteur. Ce qui est propre au catalogue reste : les sections-modules,
les runtimes et ce que act ne joue pas, le modèle de validation.

L'« Anatomie d'un lab » du CONTRIBUTING garde ses conventions et renvoie
au guide de l'auteur et au contrat de dsoxlab.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@stephrobert
stephrobert merged commit 4b283eb into main Nov 14, 2026
7 checks passed
@stephrobert
stephrobert deleted the docs/moteur-par-lien branch November 14, 2026 11:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant