Constat
Le README de MyIA.AI.Notebooks/SymbolicAI/SymbolicLearning/README.md (635 lignes) commence par un bloc introductif dense sans rupture ## :
- Titre (une ligne)
- Breadcrumb
- Bloc
<!-- CATALOG-STATUS:START -->...:END --> (artefact généré par l'automatisation)
- Paragraphe unique long : description de la série SL-1 → SL-12b (parcours, contenu pédagogique, type d'audience)
- Section inline "À qui s'adresse cette série" — mélange
kernel + dépendances par notebook + prérequis dans un seul paragraphe
- Paragraphes "Parité .NET ⇄ Python" — notions transverses sur la stratégie de portage
- Paragraphes "Compagnon Lean" — références croisées vers la série Lean frère
Tout ce bloc tient en ~80 lignes denses sans aucune coupure ##. Le reste du README (de ## Pourquoi cette série à ## Parcours d'apprentissage puis ### Phase 1...6) est bien aéré et bien structuré.
Impact utilisateur
- L'impression visuelle est indigeste : un lecteur qui ouvre le README voit un mur de prose qui contraste violemment avec le reste aéré. C'est un signal de manque de soin qui ne reflète pas le contenu réel (la série est bien construite et bien narrée en aval).
- La navigation est dégradée : pas d'ancres
## pour sauter vers "À qui s'adresse cette série" ou "Prérequis" — il faut scroller.
- Le repérage sémantique est perdu : "À qui s'adresse cette série" et "Prérequis" sont des questions distinctes que le lecteur peut se poser séparément ; les fusionner en un paragraphe brouille la réponse.
Diagnostic : ce n'est PAS une mauvaise greffe
Il s'agit d'un bloc introductif monolithique délibéré (probablement écrit d'un jet), sans avoir été re-découpé en sous-sections par la suite. La structure aval est très propre (## + ### Phase N), donc ce n'est pas un défaut de compétence — c'est un défaut d'aération de l'introduction.
Suggestion de structure (à valider avec la lane pédagogique)
Découpage ## proposé :
| # |
Nouvelle section |
Contenu |
| 1 |
Titre + breadcrumb + CATALOG-STATUS |
(inchangé) |
| 2 |
## Présentation (ou ## Vue d'ensemble synthétique) |
Paragraphe unique SL-1 → SL-12b condensé |
| 3 |
## À qui s'adresse cette série |
Profil d'audience (étudiants / chercheurs / ingénieurs) |
| 4 |
## Prérequis et dépendances |
Kernels, dépendances Python / .NET / Lean par notebook |
| 5 |
## Parité .NET ⇄ Python |
Stratégie de portage et état actuel |
| 6 |
## Compagnon Lean |
Liens vers la série Lean frère |
| 7 |
## Séries connexes |
Liens SymbolicAI/Tweety/SemanticWeb/Planning/SmartContract |
Le reste du README (## Pourquoi cette série, ## Objectifs d'apprentissage, etc.) est inchangé.
Contexte git
- Dernier commit :
eb2b83054b17 feat(symboliclearning): add spectral logic synthesis notebook (#14641) (SL-12b)
- Commits antérieurs notables :
ba8065ef4aa8 feat(lean-notebook,#11703), 735c49b66d3c docs(symboliclearning,#3975) reconcile prose 12 -> 20
Travail préalable de recherche
La section "À qui s'adresse cette série" + dépendances pourrait être sourcée depuis l'inventaire des kernels / dépendances de la série (MyIA.AI.Notebooks/SymbolicAI/SymbolicLearning/). Cf scripts/notebook_tools/ pour les extracteurs.
Hors scope de cette issue
- Réécriture de la prose elle-même (fond, choix pédagogiques, ordre des SL-X) — seulement aération structurelle.
- Changement du catalogue
COURSE_CATALOG.generated.* (artefact généré, owned by automation cf catalog-pr-hygiene Règle HARD 1).
- Création d'un sibling
.en.md (cf readme-french-first, chantier séparé).
Pourquoi une issue plutôt qu'une PR directe
- Pas une lane worker active sur ce dossier (la lane
myia-po-2027:CoursIA-2 n'a pas de grain claimé sur MyIA.AI.Notebooks/SymbolicAI/SymbolicLearning).
- Tell variation-protocol §1 : la prose pédagogique est un grain qui mérite revue (anti-régression C.4 sur le contenu, pas que la forme).
- Tell c.984-L1 strict : PR doit être CLEAN MERGEABLE + APPROVED — un changement de prose pédagogique substantiel mérite une review pedagogical-prose-mandate avant merge.
- Issue = canal canonique pour ce type de proposition structurelle ; la PR suivra une fois le scope validé avec la lane pédagogique.
See #5985 (READMEs de série : réorganiser du plus saillant au plus spécifique, parent conceptuel).
— lane myia-po-2027:CoursIA-2 (diagnostic c.1011, suite à question user ad-hoc sur le formatage du README)
Constat
Le README de
MyIA.AI.Notebooks/SymbolicAI/SymbolicLearning/README.md(635 lignes) commence par un bloc introductif dense sans rupture##:<!-- CATALOG-STATUS:START -->...:END -->(artefact généré par l'automatisation)kernel+dépendances par notebook+prérequisdans un seul paragrapheTout ce bloc tient en ~80 lignes denses sans aucune coupure
##. Le reste du README (de## Pourquoi cette sérieà## Parcours d'apprentissagepuis### Phase 1...6) est bien aéré et bien structuré.Impact utilisateur
##pour sauter vers "À qui s'adresse cette série" ou "Prérequis" — il faut scroller.Diagnostic : ce n'est PAS une mauvaise greffe
Il s'agit d'un bloc introductif monolithique délibéré (probablement écrit d'un jet), sans avoir été re-découpé en sous-sections par la suite. La structure aval est très propre (
##+### Phase N), donc ce n'est pas un défaut de compétence — c'est un défaut d'aération de l'introduction.Suggestion de structure (à valider avec la lane pédagogique)
Découpage
##proposé :## Présentation(ou## Vue d'ensemble synthétique)## À qui s'adresse cette série## Prérequis et dépendances## Parité .NET ⇄ Python## Compagnon Lean## Séries connexesLe reste du README (
## Pourquoi cette série,## Objectifs d'apprentissage, etc.) est inchangé.Contexte git
eb2b83054b17 feat(symboliclearning): add spectral logic synthesis notebook (#14641)(SL-12b)ba8065ef4aa8 feat(lean-notebook,#11703),735c49b66d3c docs(symboliclearning,#3975) reconcile prose 12 -> 20Travail préalable de recherche
La section "À qui s'adresse cette série" + dépendances pourrait être sourcée depuis l'inventaire des kernels / dépendances de la série (
MyIA.AI.Notebooks/SymbolicAI/SymbolicLearning/). Cfscripts/notebook_tools/pour les extracteurs.Hors scope de cette issue
COURSE_CATALOG.generated.*(artefact généré, owned by automation cf catalog-pr-hygiene Règle HARD 1)..en.md(cf readme-french-first, chantier séparé).Pourquoi une issue plutôt qu'une PR directe
myia-po-2027:CoursIA-2n'a pas de grain claimé surMyIA.AI.Notebooks/SymbolicAI/SymbolicLearning).See #5985 (READMEs de série : réorganiser du plus saillant au plus spécifique, parent conceptuel).
— lane
myia-po-2027:CoursIA-2(diagnostic c.1011, suite à question user ad-hoc sur le formatage du README)