History 0.0.1-alpha.4 — documentation governance

Statut

FAIL

Le contenu documentaire de la tranche est cohérent, mais deux commandes de la gate opérateur utilisent des backticks non échappés dans des chaînes Bash entre guillemets doubles. Bash les a donc interprétés comme des substitutions de commande au lieu de les transmettre littéralement à grep.

Baseline

Version observée par l'opérateur :

0.0.1-alpha.4

Le delta 0.0.1-alpha.4 a été appliqué après commit de 0.0.1-alpha.3 avec son history.

Validation opérateur observée

Les contrôles structurels et Git suivants ont réussi :

test "$(cat VERSION)" = "0.0.1-alpha.4"
test -f docs/rules/300-DOCUMENTATION.md
grep -Fx '<!-- file: docs/rules/300-DOCUMENTATION.md -->' 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 '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 RULES.md docs/rules/000-README.md docs/rules/300-DOCUMENTATION.md \
    deltas/0.0.1/alpha.4.md
git diff --cached --check
git status --short

git diff --check et git diff --cached --check n'ont produit aucun diagnostic.

La sortie finale observée avant ajout du présent history était :

M  RULES.md
M  VERSION
A  deltas/0.0.1/alpha.4.md
M  docs/rules/000-README.md
A  docs/rules/300-DOCUMENTATION.md

Défaut de gate identifié

La commande suivante contenait des backticks non échappés dans une chaîne entre guillemets doubles :

grep -F "`USAGE.md` est un guide d'utilisation durable" docs/rules/300-DOCUMENTATION.md

Bash a tenté d'exécuter USAGE.md comme une commande. Le grep résultant a malgré tout trouvé un fragment plus court, produisant un faux positif.

La commande suivante avait le même défaut :

grep -F "PGR MUST NOT créer d'arborescence `fr/`, `en/`, `de/`" docs/rules/300-DOCUMENTATION.md

Bash a tenté d'exécuter fr/, en/ et de/ ; l'assertion attendue n'a donc pas été validée.

Conséquence

alpha.4 est enregistrée en FAIL pour défaut de gate opérateur. Le contenu normatif n'a pas besoin d'être réécrit.

La tranche suivante est 0.0.1-alpha.4.fix.1, limitée à une revalidation correcte des assertions de alpha.4 avec un quoting Bash sûr. Aucun REPLAN n'est requis.

2.7 KiB Raw Blame History