Skip to content

[P0] docs/catalog-author.md décrit encore le piège des fixtures que 0.1.84 a supprimé #195

Description

@stephrobert

État vérifié

docs/catalog-author.md:115 porte encore :

5. An undeclared fixture is not copied, and nothing says so.

C'était vrai jusqu'en 0.1.83. Ça ne l'est plus : validate-structure compare
désormais fixtures/ et runtime.fixtures dans les deux sens — déclarée mais
absente, présente mais non déclarée, et chemin qui sort du workdir — et
ShellRuntime fait échouer run au lieu d'avertir dans un journal.

La documentation dit donc aujourd'hui l'inverse du comportement, sur le point
précis qui avait rendu 7 labs injouables.

Pourquoi c'est P0

C'est la page que lit un auteur de catalogue. Elle lui apprend à se méfier d'un
piège qui n'existe plus, et lui cache le garde-fou qui le protège désormais.

Le drift a été introduit par le correctif lui-même : le comportement, le
CLAUDE.md et le CHANGELOG ont été mis à jour, cette page non.

Critères d'acceptation

  • La section 5 décrit le comportement de 0.1.84 : une fixture non déclarée
    est ignorée à l'exécution, et validate-structure la signale avant
    livraison.
  • Le cas « déclarée mais absente du disque » est mentionné : il fait échouer
    run en code 2, en nommant toutes les fautives d'un coup.
  • L'exemption des fichiers cachés (.gitkeep) est dite.
  • Parité EN/FR : docs/catalog-author.fr.md reçoit la même correction.
  • Les autres « pièges » de cette page sont relus au passage : le même
    correctif a pu en périmer d'autres.

Relevé en confrontant au code une analyse externe du dépôt, le 2026-08-24.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions