Skip to content

Reorganisation narrative des annexes lakes Lean -- consolider en markdown structure #19522

Description

@jsboige

Part of #11703 (visibilité des lakes Lean dans les notebooks).

Demandée par le mainteneur sur #19439 (commentaire du 2026-10-06T08:23:01Z) :

« Il me semble que le format de ces annexes interminables a fait son temps. Ca mériterait une issue de réorganisation narrative qui consolide proprement toutes ces annexes en enrichissant le markdown dans une progression pédagogique plus structurée, avec plus de profondeur (descendre d'un niveau de sous-titres dans la structuration) »

Constat

Les annexes produites par le chantier de visibilité lakes (#11703) s'empilent en queue de carnet comme des sections plates ## Annexe — <sujet>, sans progression narrative ni transition avec le corps du cours. Le geste rend les modules noirs visibles — le défaut est narratif.

Périmètre mesuré au 2026-10-06

Inventaire exhaustif repo-wide des headings Annexe : seuls 2 carnets portent le pattern du chantier :

Carnet Sections Détail
SymbolicAI/Lean/Lean-15c-Lean-Grothendieck-Companion.ipynb 6 ## Annexe — SheafCondition (#11703) · Du crible fermé à la faisceautisation Plus · Les tiges (stalks) (#11703) · Des ouverts au préfaisceau gratte-ciel (#11703) · Faisceaux flasques et résolution de Godement (#11703) · Sites, topologies et comparaisons (#11703)
Search/Discrepancy/Discrepancy-02-Komlos-Lean.ipynb 1 ## Annexe — ErdosSpencer/Moments : la machinerie des moments (#11703)

Hors périmètre, mesuré (annexes pédagogiques préexistantes, motifs distincts — ne pas toucher) : Lean-16b (Annexes A-G), Lean-22 (A-B), Lean-31 (A-D), SW-11 Python/C# (A-C kglab/OWLReady2), SC-07c (preuve exo 2), SL-1b (solutions), Lean-36 (« Annexe A de Tegmark » = référence au livre).

Modèle cible déjà dans le dépôt : le format « ## Annexes — approfondissements optionnels + ### Annexe A/B/C… » de Lean-16b et Lean-31 — un chapitre continu, lettré, un niveau de sous-titres plus bas. La consolidation de Lean-15c peut reprendre cette forme.

Travail demandé

  1. Consolider : replacer chaque annexe dans la progression pédagogique du carnet — section markdown enrichie au fil du cours plutôt qu'empilement final ; regrouper les annexes d'un même thème mathématique en un chapitre continu (modèle Lean-16b/31).
  2. Enrichir : plus de profondeur narrative — le pourquoi mathématique avant le #check, la lecture APRÈS la sortie, transitions avec le corps existant.
  3. Préserver le contenu factuel : les déclarations citées et leurs liens ne se perdent pas — reformatage narratif, pas une purge.
  4. Une PR par carnet ; markdown-only ou cellules déplacées sans modification de code → re-exécution due seulement si une cellule source code bouge (C.2/C.3).

Critères d'acceptation

  • Lean-15c restructuré (carnet pilote, le plus chargé) — plus aucun ## Annexe — orphelin en queue ; contenu intégré sous chapitres thématiques.
  • Discrepancy-02 traité.
  • Compte de déclarations lakes citées avant/après identique (rien de perdu — grep témoin #11703 + lake).
  • Aucun carnets hors périmètre touché par ces PRs.

Sans parent supplémentaire : fille directe de l'EPIC #11703.

Activity

  1. jsboige commented on Oct 6, 2026

    @jsboige
    OwnerAuthor

    [CLAIMED] lane myia-po-2024:CoursIA-2 -- paths: MyIA.AI.Notebooks/SymbolicAI/Lean/Lean-15c-Lean-Grothendieck-Companion.ipynb, MyIA.AI.Notebooks/Search/Discrepancy/Discrepancy-02-Komlos-Lean.ipynb

  2. jsboige commented on Oct 6, 2026

    @jsboige
    OwnerAuthor

    Reorg livre en deux PR (Une PR par carnet) :

    • Lean-15c : Reorg(lean,#19522): Lean-15c annexes groupees par theme, hierarchie 3 niveaux #19573

      • 6 annexes plates -> wrapper thematique A/B (Faisceaux / Cohomologie)
      • Hierarchie 3 (## Annexes > ### A/B > #### A.X) ; lecture descend de ### Lecture a paragraphe en **Lecture de la sortie** dans la sous-section
      • 45 -> 48 cellules (24 cours + 1 conclusion + 1 wrapper ## + 2 wrappers ### A/B + 20 annexes)
      • +91/-77, 18 cellules code preservees verbatim (C.2 non du)
    • Discrepancy-02-Komlos : Reorg(lean,#19522): Discrepancy-02 annexe unique dans wrapper thematique #19577

      • 1 annexe unique -> wrapper ## Annexes + ### Annexe A + #### A.1
      • Wrapper preserve malgre une seule annexe, pour coherence du nouveau format
      • 39 -> 41 cellules (34 cours + 1 conclusion + 1 wrapper ## + 1 wrapper ### A + 4 annexes)
      • +67/-48, 15 cellules code preservees verbatim

    Validation : nbformat valide (MissingIDFieldWarning pre-existant non bloquant), execution_count et outputs preserves partout, C.2 non du (cellules deplacees non modifiees), pas de regle H.3 ou C.1 violee.

    Source-only, pas de re-execution (lake WSL natif requis, hors perimetre de cette lane).

    Refs #19522, #11703, #19439.

  3. added a commit that references this issue on Oct 7, 2026
  4. added a commit that references this issue on Oct 7, 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