Skip to content

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

Merged
stephrobert merged 2 commits into
mainfrom
docs/moteur-par-lien
Nov 14, 2026
Merged

stephrobert merged 2 commits 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 / Anatomie d'un lab ». L'arbre et ses conventions restent. Une phrase renvoie au guide de l'auteur et au contrat de dsoxlab.

Corrigé

  • La ligne de l'arbre sur lab.fr.yaml disait « title/description UNIQUEMENT ». Le contrat de dsoxlab, corrigé par dsoxlab#374, dit que lab.<langue>.yaml surcharge aussi le libellé de chaque critère. La ligne le dit désormais.

Ce qui reste propre au catalogue

  • Le fil rouge notes-api, le parcours et les garde-fous propres au catalogue : inchangés.
  • 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. Le clone local de Stéphane n'a pas été touché : il porte un validation-labs.json non commité. Le travail a été fait dans un clone jetable.

🤖 Generated with Claude Code

stephrobert and others added 2 commits November 14, 2026 12:45
…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 : l'ordre des versions, le
contrôle des schémas, les runtimes réellement employés.

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>
Le contrat de dsoxlab le dit désormais (dsoxlab#374) : un lab.<langue>.yaml
surcharge title, description et le label de chaque critère.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@stephrobert
stephrobert merged commit b740057 into main Nov 14, 2026
8 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