docs/archive/README.md

Archive documentaire — Picarones

Archived document. Cette zone contient des documents historiques : audits, plans de migration, roadmaps obsolètes, changelogs antérieurs au rewrite architectural complet. Ils sont conservés pour la traçabilité et la mémoire institutionnelle du projet, mais ne font pas partie de la documentation active.

Pour la documentation à jour, voir docs/index.md.

---

Note de repositionnement (2026-05-23)

Les documents archivés ici utilisent la dénomination interne « v2.0 » pour désigner l'aboutissement du rewrite architectural en 8 couches (mai 2026). Cette dénomination, qui reflétait une logique de refactor interne plutôt qu'une release publique mûre, a été repositionnée en 0.9.0 lors de l'alignement du projet sur SemVer pré-1.0.

Le contenu de l'archive n'a volontairement pas été réécrit : modifier le passé pour faire coïncider la terminologie avec le présent serait une réécriture d'historique trompeuse. Lis donc « v2.0 » dans les fichiers archivés comme « l'état du code à la clôture du rewrite, devenu 0.9.0 au repositionnement ».

Politique de versionning actuelle : voir docs/explanation/versioning.md.

---

Pourquoi cette séparation

À l'aboutissement du rewrite architectural (mai 2026), le projet a clôturé sa migration legacy. Les artefacts qui décrivaient ces chantiers (handovers de session, plans de retrait, audits institutionnels, status reports) restent utiles pour comprendre comment le code a évolué, mais ils ne décrivent pas l'état actuel.

Les laisser dans la documentation active créait deux confusions :

1. Pour les nouveaux contributeurs : impression que le projet était encore en chantier, alors que la posture v2.0 est « release ».
2. Pour les outils CI (ratchet test_doc_paths, validation mkdocs strict) : ces fichiers contiennent des références à du code supprimé qui empêchaient mécaniquement le compteur de dette de décroître.

L'archive résout les deux : zone explicite, exclue de la nav active et du ratchet, bannière en tête de chaque sous-dossier.

---

Contenu

2026-audits/

Audits institutionnels et plans de remédiation produits en mai 2026, préalables au tag v2.0.

• institutional-readiness-2026-05.md — audit BnF / LoC / BL
• remediation-plan-2026-05.md — plan d'action issu de l'audit

2026-migration/

Plans, handovers et inventaires liés au rewrite et à la suppression du legacy (lots A-H, mai 2026).

• legacy-retirement-plan.md — plan de retrait des paquets legacy
• pipeline-convergence-plan.md — convergence des deux pipelines
• rewrite-status-s46.md — état d'avancement Sprint 46
• executor-equivalence.md — preuve d'équivalence des exécutants
• option-b-user-guide.md — guide de migration vers Option B
• option-b-test-inventory.md — inventaire des tests touchés
• session-handover.md — handover entre sessions de travail
• sprint-D-audit.md — audit du sprint D
• regression-tolerances.md — tolérances de régression mesurées

2026-roadmap/

Plans stratégiques pré-v2.0 (le backlog vivant est dans /docs/roadmap/backlog.md).

• evolution.md — plan d'évolution 2026 (axes A et B)
• rewrite.md — plan du rewrite 2026 (S1–S26)

changelog-pre-v2.md

Historique de versions 0.1.0 → 1.x + chantiers pré-v2.0. Le CHANGELOG actif (post-v2.0) vit à la racine du repo dans /CHANGELOG.md.

---

Politique de modification

Les fichiers archivés sont figés. Toute correction substantielle doit aller dans la documentation active, pas dans l'archive. Les seules modifications acceptables ici sont :

• ajouter le bandeau « Archived document » s'il manque ;
• corriger des typos évidentes ;
• ajouter des notes en tête pour préciser le contexte historique.

Les chemins Python obsolètes (picarones.measurements, picarones.core, etc.) restent volontairement dans les fichiers archivés — c'est précisément pour cela qu'ils sont archivés. Le test tests/architecture/test_doc_paths.py exclut docs/archive/** de son périmètre.