algo/docs/features/collatz_conjoncture_rationalization_tooling.md
ncantu ab56157c05 collatz: rationalize conjoncture document into annexes
**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
2026-03-09 04:56:32 +01:00

49 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

**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 quun 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 danalyse (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.