nicolas.cantu/algo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
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

1.6 KiB
Raw Blame History

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) :

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 :

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.