85 lines
2.4 KiB
Markdown
85 lines
2.4 KiB
Markdown
<!-- file: deltas/0.0.1/alpha.4.fix.1.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta 0.0.1-alpha.4.fix.1 — safe documentation gate quoting
|
|
|
|
## Baseline
|
|
|
|
Version attendue avant application :
|
|
|
|
```text
|
|
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 :
|
|
|
|
```text
|
|
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 :
|
|
|
|
```text
|
|
VERSION
|
|
```
|
|
|
|
ADD :
|
|
|
|
```text
|
|
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
|
|
|
|
```bash
|
|
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 :
|
|
|
|
```text
|
|
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.
|