**Motivations:** - Make `conjoncture_collatz.md` indexable and avoid duplicated trunks. **Root causes:** - Multiple full copies of the formal trunk and a large non-formal imported block prevented unambiguous references. **Correctifs:** - Move duplicated trunks and the imported non-formal block to `conjoncture_collatz_annexes.md`. - Make generic repeated headings unique via deterministic numbering (CSP/CE). **Evolutions:** - Add deterministic audit + rationalization scripts and versioned audit artefacts. **Pages affectées:** - applications/collatz/conjoncture_collatz.md - applications/collatz/conjoncture_collatz_annexes.md - applications/collatz/collatz_k_scripts/collatz_conjoncture_audit.py - applications/collatz/collatz_k_scripts/collatz_conjoncture_rationalize.py - docs/artefacts/collatz/conjoncture_rationalisation/* - docs/features/collatz_conjoncture_rationalization_tooling.md - docs/collatz_conjoncture_collatz_cartographie.md
49 lines
1.6 KiB
Markdown
49 lines
1.6 KiB
Markdown
**Auteur** : Équipe 4NK
|
||
|
||
# Collatz — Rationalisation déterministe de `conjoncture_collatz.md`
|
||
|
||
## Objectif
|
||
|
||
- rendre `applications/collatz/conjoncture_collatz.md` indexable (un seul tronc canonique au début)
|
||
- isoler les duplications de tronc et les blocs non formels dans un fichier annexe
|
||
- produire un audit déterministe (duplications, TOC canonique, table de renvois) versionnable
|
||
|
||
## Impacts
|
||
|
||
- `applications/collatz/conjoncture_collatz.md` ne contient plus qu’un seul H1 `# Conjecture de Collatz: ...`
|
||
- les blocs déplacés restent disponibles, inchangés, dans un fichier annexe
|
||
- les titres génériques ciblés sont rendus uniques par numérotation
|
||
|
||
## Modifications
|
||
|
||
- scripts :
|
||
- `applications/collatz/collatz_k_scripts/collatz_conjoncture_rationalize.py`
|
||
- `applications/collatz/collatz_k_scripts/collatz_conjoncture_audit.py`
|
||
- annexes :
|
||
- `applications/collatz/conjoncture_collatz_annexes.md`
|
||
- artefacts versionnés :
|
||
- `docs/artefacts/collatz/conjoncture_rationalisation/audit_conjoncture.{json,md}`
|
||
|
||
## Modalités d’analyse (reproduction)
|
||
|
||
Rationalisation (annexes + titres uniques ciblés) :
|
||
|
||
```bash
|
||
python3 applications/collatz/collatz_k_scripts/collatz_conjoncture_rationalize.py \
|
||
--input applications/collatz/conjoncture_collatz.md \
|
||
--annex applications/collatz/conjoncture_collatz_annexes.md
|
||
```
|
||
|
||
Audit déterministe :
|
||
|
||
```bash
|
||
python3 applications/collatz/collatz_k_scripts/collatz_conjoncture_audit.py \
|
||
--input applications/collatz/conjoncture_collatz.md \
|
||
--output-dir docs/artefacts/collatz/conjoncture_rationalisation
|
||
```
|
||
|
||
## Modalités de déploiement
|
||
|
||
Aucun déploiement.
|
||
|