Skip to content

Remise d'aplomb de la nomenclature des notebooks — suffixe noyau, sans-numero, profondeur d'accretion #16231

Description

@myia-ai-01

Ce que le user a tranche

Question posee en fin de session sur le waiver du suffixe noyau pour la serie ICT (le canon #11840 exige -Python, ICT est mono-noyau, le suffixe n'y desambiguise rien). Reponse :

« oui je pense qu'on devrait faire le renommage canonique, il y a aussi la question des sans numeros, de la reorg des accretions trop nombreuses. C'est un vrai boulot de tout remettre d'aplomb alors cree une issue dediee rattachee aux existantes »

Le waiver est donc revoque. Le canon prime, et le perimetre s'elargit a trois chantiers. Cette issue les porte ensemble parce qu'ils touchent tous le nom de fichier : les separer ferait passer trois fois le meme balayage de referents sur les memes fichiers.

See #11840 (tracker de normalisation, 12 tranches livrees) · See #7260 (renumerotation ICT, §4)

Les trois chantiers, mesures sur origin/main

1284 notebooks au total ; 729 conformes a <Prefixe>-<num><lettre?>-<Titre>.ipynb, 555 hors forme.

A. Suffixe noyau — le canon est applique a 9 %

Suffixe Notebooks
aucun 662
-Python 43
-CSharp 20
-Lean 4

Le canon #11840 vaut aujourd'hui pour 67 des 729 notebooks numerotes. C'est l'ecart le plus large des trois, et le plus couteux en references : c'est lui qui justifiait le waiver ICT, desormais ecarte.

Decision user : appliquer le renommage canonique, sans waiver pour les series mono-noyau. Le suffixe noyau s'applique donc aux notebooks pedagogiques numerotes ; l'inventaire ci-dessus donne un plafond de 662 cibles sans suffixe, a classifier par serie avant decoupe en tranches. Ce n'est pas une invitation a renommer aveuglement les quantbooks, scripts-notebooks ou artefacts qui ne relevent pas de la progression pedagogique : leur inclusion se prouve par le tri du chantier B, pas par l'extension du glob.

B. Notebooks sans numero — 555, tres concentres

Serie Sans numero
QuantConnect 214
GenAI 135
SymbolicAI 81
ML 66
RL 27
IIT 10
GameTheory 8
CaseStudies 6
Probas 5

Deux familles a ne pas confondre, et le tri est le premier travail : QuantConnect (214) est majoritairement du code de strategie et des quantbooks, pas une progression pedagogique numerotable — les numeroter serait fabriquer un ordre qui n'existe pas. A l'inverse GenAI et ML portent de vraies progressions dont le numero manque.

C. Profondeur d'accretion — seulement 4 groupes hors norme

La norme de .claude/rules/notebook-accretion-numbering.md est e-f au maximum. Sur 407 groupes numerotes, 4 la depassent :

Groupe Accretions Jusqu'a
ICT-15 12 l
Lean-16 10 j
GameTheory-03 8 h
GameTheory-06 8 h

C'est le chantier le plus petit et le plus facile a livrer en premier. Chaque eclatement demande un argument pedagogique ecrit : une accretion profonde n'est un defaut que si les derniers grains ne sont plus des variations du meme objet.

Contraintes qui ne se negocient pas

  • git mv uniquement, aucune edition de contenu dans la meme PR (§5.6 de la rule : un renommage et une edition de contenu ne se reviewent jamais ensemble).
  • La table de mapping va dans l'issue AVANT la PR, jamais decouverte a la lecture du diff.
  • 863 references « nues » mesurees (ICT-7 en prose, sans tiret ni lettre derriere) dont 28 en cellule code et 9 en sortie committee. Un balayage par <Prefixe>-N- seul les rate. Les 9 sorties committees imposeraient une re-execution : interdiction de hand-editer une sortie (C.2 + secrets-hygiene regle 6) — on corrige la cause et on re-execute, ou on borne le perimetre.
  • Six surfaces cassent a chaque renum, cinq ont un organe sur main (check_notebook_navlinks.py, check_docs_links.py, detect_link_target_regression.py, check_notebook_link_render.py, check_link_label_agreement.py). Les passer apres chaque tranche.
  • Catalogue byte-identique a main : COURSE_CATALOG.generated.* et les blocs CATALOG-STATUS ne se regenerent jamais a la main sur une branche feature.

Ordre propose

  1. C (4 groupes) — le plus petit, valide la chaine complete renommage + balayage + organes sur un volume ou une erreur se rattrape.
  2. Classification de A par serie — le canon est tranche ; mesurer les notebooks pedagogiques réellement concernés et exclure explicitement les artefacts qui ne portent pas une progression.
  3. A par serie, une PR par serie, jamais un composite.
  4. B — apres le tri code/pedagogie, qui est un travail editorial et pas mecanique.

La tranche ICT est deja scopee au commentaire 5673072664 de #11840 et reclamee par myia-po-2027:CoursIA ; sa table de mapping doit etre refaite pour integrer -Python, le waiver sur lequel elle reposait etant revoque.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions