76 lines
2.7 KiB
Markdown
76 lines
2.7 KiB
Markdown
<!-- file: history/0.0.1/alpha.4.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# 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 :
|
|
|
|
```text
|
|
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 :
|
|
|
|
```bash
|
|
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 :
|
|
|
|
```text
|
|
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 :
|
|
|
|
```bash
|
|
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 :
|
|
|
|
```bash
|
|
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.
|