From dec4d14b1fef9b12ca7d064c02e34d8bc7355f6e Mon Sep 17 00:00:00 2001 From: jsboige Date: Mon, 5 Oct 2026 13:51:51 +0200 Subject: [PATCH 1/2] docs(rules,#19297): criteres de sortie de la finition de serie Ajoute a la regle des notebooks les criteres de sortie d'une serie en finition : objectifs dans le README de serie, blocs de fin de carnet (A retenir, Verifiez votre comprehension, Pour aller plus loin), capstone la ou il vient naturellement. Detail dans docs/reference/finition-de-serie.md. Regime valide par le mainteneur en session directe le 2026-10-05. Co-Authored-By: Claude Opus 5.5 (1M context) --- .claude/rules/notebook-conventions.md | 1 + docs/reference/finition-de-serie.md | 44 +++++++++++++++++++++++++++ 2 files changed, 45 insertions(+) create mode 100644 docs/reference/finition-de-serie.md diff --git a/.claude/rules/notebook-conventions.md b/.claude/rules/notebook-conventions.md index 9363bd2ff1..cd8c5f58f3 100644 --- a/.claude/rules/notebook-conventions.md +++ b/.claude/rules/notebook-conventions.md @@ -22,6 +22,7 @@ paths: MyIA.AI.Notebooks/**/*.ipynb - Interpretation APRES chaque output significatif - Introduction de section AVANT le code qu'elle introduit - Conclusion avec table recap en fin de section majeure +- **Série en finition** (régime #19297) : README de série avec `## Objectifs d'apprentissage` ; chaque carnet du chemin principal finit par `## À retenir`, `## Vérifiez votre compréhension` (questions tirées du carnet, réponse repliée) et `## Pour aller plus loin` ; capstone là où il vient naturellement. Série par série, jamais en reprise de masse ; markdown seul, donc sans ré-exécution (C.2/C.3). Détail : [finition-de-serie.md](../../docs/reference/finition-de-serie.md). ## Enchainement et ordre canonique des cellules (Epic #3240) diff --git a/docs/reference/finition-de-serie.md b/docs/reference/finition-de-serie.md new file mode 100644 index 0000000000..3710dc6cb4 --- /dev/null +++ b/docs/reference/finition-de-serie.md @@ -0,0 +1,44 @@ +# Finition de série : critères de sortie + +Régime validé par le mainteneur le 2026-10-05 (issue de suivi #19297). Une série passe en **finition** quand on cesse d'y ajouter des carnets pour la rendre lisible de bout en bout. Elle en sort quand les critères ci-dessous sont remplis. + +## Critères + +1. **Objectifs de série.** Le README de la série a une section `## Objectifs d'apprentissage`. Elle dit ce que le lecteur saura faire à la fin, en phrases vérifiables (« implémenter A* et justifier son admissibilité »), jamais en thèmes (« la recherche heuristique »). +2. **Blocs de fin de carnet.** Chaque carnet du chemin principal de la série se termine par trois blocs markdown, dans cet ordre : + + | Bloc | Contenu | + |---|---| + | `## À retenir` | 3 à 5 points, chacun tiré de ce que le carnet a effectivement montré (une sortie, une mesure, une preuve) | + | `## Vérifiez votre compréhension` | 2 à 4 questions dont la réponse se trouve dans le carnet. La réponse suit, repliée (`
`) ou en fin de bloc | + | `## Pour aller plus loin` | le carnet suivant de la série, puis lectures et carnets voisins d'autres séries | + + Le tableau récapitulatif de fin de section majeure (déjà exigé) reste en place : « À retenir » le complète, il ne le remplace pas. +3. **Capstone, là où il vient naturellement.** Un carnet qui réinvestit plusieurs carnets de la série sur un problème plus grand. Il n'est pas exigé dans une série où aucun problème ne s'y prête. Si la série n'en a pas, son README le dit en une phrase. + +Au niveau du dépôt : un **parcours 0 de 2 h**, tiré du chemin local existant (Search → Sudoku → ML, README racine) et chronométré, est proposé en entrée. + +## Comment appliquer + +- **Série par série**, quand la série passe en finition. Pas de reprise rétroactive en masse sur les séries qui ne sont pas en finition. +- **Écrire depuis le contenu.** Les points « À retenir » et les questions « Vérifiez » se rédigent après lecture du carnet et de ses sorties. Une question générique (« qu'avez-vous appris ? ») ne compte pas. +- **Markdown seulement.** Ajouter ces blocs ne modifie aucune cellule de code : la ré-exécution n'est pas requise (C.2), et les sorties des carnets non modifiés ne se re-sérialisent pas (C.3). +- **Ne pas toucher deux fois un carnet.** Quand une série a aussi une réorganisation en cours, les blocs commencent par les carnets qui ne sont pas renommés. Les carnets renommés reçoivent leurs blocs après le renommage. +- **Pas de nouvelle taxonomie.** Les classements de maturité existants restent les seuls ; ce régime n'en ajoute pas. + +## Mesure + +Comptage de départ (2026-10-05, 1492 carnets hors `_archive` et `_output`, sur les titres des cellules markdown) : +- « À retenir » : 14 % des carnets ; +- « Vérifiez votre compréhension » : 1 % ; +- « Pour aller plus loin » : 18 %. + +Une section d'objectifs manque dans 5 READMEs de série sur 14 : Complexity, Compression, NLP, RL, SymbolicAI. + +La mesure par série est portée par un script dédié (à écrire, cf #19297), qui permet de déclarer une série finie sans recompter à la main. + +## Ordre de passage + +1. Search (carte validée, #19253) ; +2. RL (#19255) ; +3. les séries sans objectifs : Complexity, Compression, NLP, SymbolicAI. From 3f41d8c7af37927d54d08bb75221239e121e3e5d Mon Sep 17 00:00:00 2001 From: jsboige Date: Mon, 5 Oct 2026 14:34:22 +0200 Subject: [PATCH 2/2] docs(rules,#19297): mesure -- titre voisin a renommer vs bloc absent, chemin principal sans profondeur Precise ce que mesure le script de #19297, d'apres le rejeu de #19303 sur le corpus : le comptage de depart inclut les titres voisins (Points cles a retenir, Ce qu'il faut retenir, titres numerotes) ; une serie n'est finie qu'aux titres du tableau, et la mesure separe renommer d'ecrire. Le chemin principal comprend les sous-dossiers, hors _archive/_output et exclusions nommees au README -- pas une profondeur de dossier (ML : 23 carnets sur 128 au filtre depth<=1). Co-Authored-By: Claude Opus 5.5 (1M context) --- docs/reference/finition-de-serie.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/reference/finition-de-serie.md b/docs/reference/finition-de-serie.md index 3710dc6cb4..97e5f78b6b 100644 --- a/docs/reference/finition-de-serie.md +++ b/docs/reference/finition-de-serie.md @@ -35,6 +35,10 @@ Comptage de départ (2026-10-05, 1492 carnets hors `_archive` et `_output`, sur Une section d'objectifs manque dans 5 READMEs de série sur 14 : Complexity, Compression, NLP, RL, SymbolicAI. +Ce comptage de départ inclut les titres voisins : « Points clés à retenir », « Ce qu'il faut retenir », et les titres numérotés comme « ## 7. Pour aller plus loin ». Ce sont les formes les plus fréquentes du dépôt. Une série n'est **finie** qu'avec les titres du tableau ci-dessus. La mesure distingue donc un bloc **présent sous un titre voisin**, qu'il suffit de renommer, d'un bloc **absent**, qu'il faut écrire. Ce partage sert à répartir le travail. + +Le chemin principal d'une série est l'ensemble de ses carnets, sous-dossiers compris. En sont exclus `_archive`, `_output`, ainsi que les dossiers que le README de la série écarte nommément. Il ne se définit pas par une profondeur de dossier. + La mesure par série est portée par un script dédié (à écrire, cf #19297), qui permet de déclarer une série finie sans recompter à la main. ## Ordre de passage