Skip to content

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

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).

Remplacé par un lien

  • README.md / README.fr.md : 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 ». Le texte est exactement celui du squelette.

Corrigé (vérité et source dans dsoxlab)

  • dsoxlab status # check they answer devient dsoxlab infra status. status donne l'état d'un lab ; la joignabilité des hôtes, c'est infra status (docs/commands.md).
  • « every runtime.host points to a declared host » : ce champ n'a jamais été lu. L'hôte se déclare dans runtime.targets[].host (docs/contract-v1.md).
  • La table des runtimes kvm/incus/shell devient shell (l1) et vm (l2 et plus). kvm et incus ne sont que des alias de vm, et le backend vient de infra.provider.
  • CONTRIBUTING :
    • le matériel de départ vit dans fixtures/, et run le copie dans challenge/work/ ;
    • « VM (kvm/incus) » devient vm ;
    • lab.fr.yaml surcharge aussi les libellés de critères (dsoxlab#374).
  • Une entrée CHANGELOG, en EN et en FR.

Mesure

validate-structure --json, joué avec le moteur de dsoxlab main :

  • avant : stale_doc = 4 ;
  • après : stale_doc = 0, aucune autre anomalie.

Les hooks pre-commit ont tourné au commit.

🤖 Generated with Claude Code

stephrobert and others added 2 commits November 14, 2026 12:40
…xlab#201)

Le README ne recopie plus le contrat ni le cycle de vie d'un lab : il
renvoie aux pages de dsoxlab. Corrige quatre affirmations devenues
fausses : `dsoxlab infra status` (pas `status`) pour la joignabilité,
`runtime.targets[].host` (pas `runtime.host`), deux runtimes `shell` et
`vm` (kvm, incus, outscale sont des providers), matériel de départ dans
`fixtures/` copié par `run` dans `challenge/work/`.

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 7f45056 into main Nov 14, 2026
7 checks passed
@stephrobert
stephrobert deleted the docs/moteur-par-lien branch November 14, 2026 12:06
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