Files
pgr/deltas/0.0.1/alpha.4.fix.1.md

2.4 KiB

Delta 0.0.1-alpha.4.fix.1 — safe documentation gate quoting

Baseline

Version attendue avant application :

0.0.1-alpha.4

Le history history/0.0.1/alpha.4.md MUST avoir été appliqué et committé avant ce delta.

Version après application :

0.0.1-alpha.4.fix.1

Objet

Corriger uniquement la preuve opérateur de alpha.4. Le contenu normatif de docs/rules/300-DOCUMENTATION.md est conservé tel quel ; le défaut provenait de commandes grep dont les backticks étaient interprétés par Bash.

Scope

REPLACE :

VERSION

ADD :

deltas/0.0.1/alpha.4.fix.1.md

DELETE : aucun.

Changements

  • VERSION passe à 0.0.1-alpha.4.fix.1 ;
  • aucune règle documentaire n'est modifiée ;
  • les assertions de alpha.4 sont rejouées avec les backticks échappés lorsqu'une chaîne entre guillemets doubles est nécessaire ;
  • la gate confirme ainsi réellement les passages USAGE.md et fr/ / en/ / de/ qui n'avaient pas été correctement prouvés dans alpha.4.

Validation opérateur

test "$(cat VERSION)" = "0.0.1-alpha.4.fix.1"

test -f docs/rules/300-DOCUMENTATION.md

grep -Fx '<!-- file: docs/rules/300-DOCUMENTATION.md -->' docs/rules/300-DOCUMENTATION.md
grep -F -- "\`USAGE.md\` est un guide d'utilisation durable" docs/rules/300-DOCUMENTATION.md
grep -F -- '`ROADMAP.md` décrit la trajectoire macro du projet' docs/rules/300-DOCUMENTATION.md
grep -F -- '`version` est une révision interne du fichier. Elle est indépendante de `VERSION`' docs/rules/300-DOCUMENTATION.md
grep -F -- 'Un snapshot historique MUST NOT être réécrit silencieusement' docs/rules/300-DOCUMENTATION.md
grep -F -- "PGR MUST NOT créer d'arborescence \`fr/\`, \`en/\`, \`de/\`" docs/rules/300-DOCUMENTATION.md
grep -F -- 'La documentation est une aide au développement et à la maintenance, pas une fin en soi.' docs/rules/300-DOCUMENTATION.md

git diff --check

git add VERSION deltas/0.0.1/alpha.4.fix.1.md

git diff --cached --check

git status --short

La sortie attendue avant ajout du history est :

M  VERSION
A  deltas/0.0.1/alpha.4.fix.1.md

Transition

PASS : enregistrer history/0.0.1/alpha.4.fix.1.md, committer alpha.4.fix.1, puis passer à 0.0.1-alpha.5.

FAIL : rester dans alpha.4 avec alpha.4.fix.2, sauf REPLAN si le défaut remet en cause le scope ou le plan.