Spaces:
Sleeping
Sleeping
| # 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`](../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`](../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/`](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/`](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/`](2026-roadmap/) | |
| Plans stratégiques pré-v2.0 (le backlog vivant est dans | |
| [`/docs/roadmap/backlog.md`](../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`](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`](../../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. | |