Skip to content

[docs] SymbolicLearning README : bloc introductif monolithique à aérer (sections ## manquantes) #15241

Description

@jsboige

Constat

Le README de MyIA.AI.Notebooks/SymbolicAI/SymbolicLearning/README.md (635 lignes) commence par un bloc introductif dense sans rupture ## :

  1. Titre (une ligne)
  2. Breadcrumb
  3. Bloc <!-- CATALOG-STATUS:START -->...:END --> (artefact généré par l'automatisation)
  4. Paragraphe unique long : description de la série SL-1 → SL-12b (parcours, contenu pédagogique, type d'audience)
  5. Section inline "À qui s'adresse cette série" — mélange kernel + dépendances par notebook + prérequis dans un seul paragraphe
  6. Paragraphes "Parité .NET ⇄ Python" — notions transverses sur la stratégie de portage
  7. 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)

Activity

  1. myia-po-2023 commented on Sep 9, 2026

    @myia-po-2023
    Collaborator

    [CLAIMED] #15241 — myia-po-2023:CoursIA-2 2026-09-10T01:15Z — Grain: MED/docs — paths: MyIA.AI.Notebooks/SymbolicAI/SymbolicLearning/README.md

    Claim-preflight fait : défaut vérifié firsthand sur origin/main (premier ## en ligne 22, bloc intro lignes 1-21 monolithique), issue sans claim, aucune PR ouverte ne touche SymbolicLearning. Aération structurelle selon la table 7 sections du body ; prose préservée, CATALOG-STATUS byte-identique, catalogue non régénéré.

  2. added a commit that references this issue on Sep 9, 2026
  3. myia-po-2023 commented on Sep 9, 2026

    @myia-po-2023
    Collaborator

    [DONE] #15241 livré par PR #15424 — lane myia-po-2023:CoursIA-2 2026-09-10T01:5xZ

    • Intro lignes 1-21 monolithique → 7 sections ## selon la table du body (Présentation, À qui s'adresse, Prérequis et dépendances, Parité .NET, Compagnon Lean natif, Séries connexes). Prose préservée : mêmes phrases, coupures de paragraphes + bullets uniquement ; paragraphe géant SL-1→SL-12b coupé en 3.
    • Rider §E (audit fichier-entier) : « Statistiques catalogue à jour » citait 21/BETA=19 alors que le bloc réel dit 22/BETA=20 (SL-12b inscrit par le cron depuis) — quote, table 6 phases, ligne Total, note maturité alignées ; SL-1b manquait à l'arbre Structure des fichiers (21→22 lignes notebooks).
    • Bloc CATALOG-STATUS byte-identique ; aucun notebook touché ; markdown seul (+43/−13).
  4. added a commit that references this issue on Sep 10, 2026
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

    documentationImprovements or additions to documentation

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions