Skip to content

reorg(dsa,#13504): renommage hub DataScienceWithAgents + sous-repertoires — plan en 5 tranches avec gate de sequencement (mandat user 2026-09-22) #17417

Description

@jsboige

Sous-EPIC de #13504. Mandat user session directe du 2026-09-22 : « il y a certains répertoires hub à renommer, et ça va être pénible, le plus tôt est le mieux. Par exemple DataScienceWithAgents, et ses sous-répertoires mériteraient un renommage. »

Constat — trois hétérogénéités de nommage dans un seul hub

MyIA.AI.Notebooks/ML/DataScienceWithAgents/ mêle :

Sous-répertoire Convention Remarque
01-PythonForDataScience NN-Title EN contient notebooks/ + tests/
02-ML-Cours NN-Title FR notebooks en 2.1..2.14d décimal point — seule série du dépôt dans cette forme (le canon est <Prefixe>-<num><lettre>, cf #5081)
03-DeepLearning NN-Title EN —
04-Vision · 04b-Wavelet-Scattering NN + accretion lettre sur le répertoire l'accretion lettre au niveau RÉPERTOIRE est unique au dépôt (canon : lettre sur le notebook)
Track1-LangChain (Day1-3) · Track2-GoogleADK (Day4-7) TrackN-Outil + DayN-* immersif bootcamp, disjoint du NN- des 01-04

Le hub lui-même (DataScienceWithAgents, CamelCase sans trait d'union, 22 caractères) est le plus long nom de série du dépôt et ne dit pas ce que la zone EST pédagogiquement (c'est le socle Python/ML/DL/Vision + deux tracks agents).

Séquencement (HARD, gate §5.4 de la règle renum)

Deux PRs ouvertes touchent les Tracks au 2026-09-22 : #17401 (Lab8, Track2-GoogleADK, #17391) et #17392 (Lab6, Track1-LangChain, #17387). Le renommage des répertoires Track* attend leur merge — nommer la gate dans chaque tranche. Les répertoires 01-..04b ne portent aucune PR ouverte (vérifié) et peuvent partir en premier.

Plan par tranches (une PR par tranche, ordre du moins au plus casse-cou)

  1. T1 — inventaire des référents (issue de mesure, pas de renommage) : navlinks intra-hub, READMEs (ML/, hub, sous-séries, racine), _quarto.yml, docs/curriculum/*, baselines JSON, translations/** (colonnes notebook des CSV concernés), catalogues étudiants si référents (le catalogue EPF couvre GenAI/** — vérifier si DSA y est référencé, la surface EPF/V06 (P1) -- la renumerotation #15085 casse 9 liens du catalogue etudiant, hors portee des trois organes de balayage #15289 est le précédent), COURSE_CATALOG.generated.* (automatisation seule).
  2. T2 — sous-répertoires 01-..04b vers le nommage arbitré (voir options).
  3. T3 — notebooks 2.N → canon <Prefixe>-<num><lettre> (le gros lot : ~25 notebooks dans 02-ML-Cours, mapping table dans l'issue fille AVANT la PR, protocole §5 intégral).
  4. T4 — Tracks après merge de docs(notebook,#17391): Lab8 — lecture ancrée sur la réponse ADK erronée (Capteurs/Processeur/Actionneurs) #17401/fix(langchain,#17387): Lab6-First-Agent — nav fusionnée canon Lab7, réponse de l'agent montée (16), ordre canon, Exercice 4 numéroté — redressement #17040 #17392 : TrackN-Outil/DayN → à arbitrer (les Day* portent une sémantique bootcamp qui peut se garder).
  5. T5 — le hub lui-même, en dernier (blast radius maximal : chemins absolus dans les forks projets étudiants potentiels, liens externes).

Options de nommage à arbitrer (user)

Le choix des NOMS CIBLES est un arbitrage user — les options, pas la décision :

Arbitrage inscrit au registre des questions user (pull, pas push) — les tranches T1/T2 ne sont pas bloquées : T1 est un inventaire, T2 n'a besoin que des noms de sous-répertoires (option la moins sensible : kebab-case des noms actuels sans changement sémantique).

Acceptance (par tranche)

  • T1 : inventaire complet posté en commentaire de cette issue (fichier × type de référence)
  • Chaque tranche de renommage : git mv seul, zéro changement de contenu, mapping table préalable, 5 organes de liens verts, baselines sans clés orphelines, comptes périmètre re-comptés (pulls/N/files --paginate)
  • Hub rename (T5) : vérification des référents hors dépôt AVANT le geste

Voir #13504 (umbrella DSA) · #5081 (nommage canonique) · #16231 (padding) · règle .claude/rules/notebook-accretion-numbering.md.

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