Skip to content

Site Pages : 1740 liens README -> .ipynb brut alors que le rendu .html existe (sweep #13025) #18911

Description

@jsboige

Constat (mesure 2026-10-03, worktree #18423)

L'audit python scripts/regen_quarto_render.py --check-readme-links rend 1740 violations STALE_LINK sur les 405 READMEs d sous-arbres rendus : des READMEs rendus continuent de lier des notebooks en .ipynb brut alors que le rendu .html sibling existe (défaut #13025 — le lien brut 404 sur Pages).

Extrait typique (SymbolicAI/Tweety/README.md, 12 liens ; cross-series/qcm/README.md, 4 liens) :

::error::STALE_LINK MyIA.AI.Notebooks/SymbolicAI/Tweety/README.md -> Tweety-07a-Extended-Frameworks-Python.ipynb
::error::STALE_LINK MyIA.AI.Notebooks/cross-series/qcm/README.md -> ../../Search/Part1-Foundations/Search-01-StateSpace.ipynb

L'audit est aujourd'hui advisory (aucun gate CI ne le consomme) — les 1740 liens sont servis en JSON brut sur le site en production.

Livrable

Une (ou quelques) PR(s) par vagues familiales : convertir les hrefs ](X.ipynb) → ](X.html) pour toute cible présente dans la render-list (scripts/regen_quarto_render.py, liste _quarto.yml). L'instrument existe (regex _IPYNB_LINK_RE + readme_link_violations()) ; il manque la moulinette de conversion déterministe + l'application.

Acceptance

Détail

See #10921 (EPIC site), See #18423 (critère 4 - sweep final), See #13025 (défaut fondateur).

Activity

  1. jsboige commented on Oct 3, 2026

    @jsboige
    OwnerAuthor

    [CLAIMED] lane myia-po-2024:CoursIA-2 -- paths: MyIA.AI.Notebooks/**/*.md, scripts/notebook_tools/fix_ipynb_links.py -- sweep #18911 (1740 violations STALE_LINK README -> .ipynb/.html), audit + moulinette canonique + garde CI.

    Grain : LIGHT/test (moulinette dediee a l audit, scripts/).
    Plancher G-VAR-1 : le grain tient par la PR de garde CI (substance regenere la garde de fond, META-tags = guard), le DEEP de CONTENU est porte par les vagues familiales de conversion qui suivront (substance en aval).

    Voir issue #18911, acceptances :

  2. added 4 commits that reference this issue on Oct 3, 2026
  3. added a commit that references this issue on Oct 3, 2026
  4. added 2 commits that reference this issue on Oct 3, 2026
  5. added a commit that references this issue on Oct 4, 2026
  6. added 4 commits that reference this issue on Oct 4, 2026
  7. added a commit that references this issue on Oct 4, 2026
  8. added a commit that references this issue on Oct 5, 2026
  9. 44 remaining items

  10. added 4 commits that reference this issue on Oct 10, 2026
  11. added 5 commits that reference this issue on Oct 10, 2026
  12. myia-ai-01 commented on Oct 10, 2026

    @myia-ai-01
    Collaborator

    [CLAIMED] lane myia-po-2025:CoursIA -- paths: MyIA.AI.Notebooks/ML//README.md, MyIA.AI.Notebooks/Search//README.md -- geste 4 de la decision c.6076029168 : retour des liens README .html -> .ipynb, par serie, au plus 15 fichiers par PR (dispatch coordinateur, feeder Vibe ; reprend le geste libere par myia-po-2025:roo-extensions le 09/10)

    Mesure sur main a 22:50Z le 10/10 : 602 lignes portant un lien .html dans 55 READMEs (ML 273/17, Search 129/6, SymbolicAI 77/10, RL 51/1, GenAI 35/5, Probas 15/6, reste 23/11). Les series suivantes s'ajoutent par [CLAIMED-AMEND] avec le scope complet. Contrat par PR : cible .ipynb existante pour chaque lien converti, aucun autre changement, delta mesure avec dump_readme_link_violations.py + diff_readme_link_violations.py.

  13. added a commit that references this issue on Oct 10, 2026
  14. jsboige commented on Oct 10, 2026

    @jsboige
    OwnerAuthor

    Collision mesurée entre la convention #18911 (liens .html rendus) et le garde readme-ipynb-links-guard — signalée depuis le cycle c.1267 (lane po-2023:CoursIA-2), pas de geste posé sur les fichiers (hors scope des PRs porteuses).

    Les fusions #19705/#20062 ont appliqué la convention .html dans les READMEs Geometry/Lean, mais 4 des liens pointent vers des pages rendues inexistantes (HTML_404 mesuré par le garde à tête de main au 2026-10-11) :

    README Lien 404
    SymbolicAI/Lean/Geometry/README.md L15 Geometry-02-From-Equation-To-Proof.html
    SymbolicAI/Lean/Geometry/README.md L20 Geometry-05-Pont-Formel-Python.html
    SymbolicAI/Lean/README.md L134 Lean-17-Conway-Bridge-to-Knots-Python.html
    SymbolicAI/README.md Lean/Geometry/Geometry-05-Pont-Formel-Python.html

    Effet de bord mesuré : ces 4 × 404 étant sur main, toute PR ouverte ayant forké avant #20062 les voit comme delta NOUVELLES=4 (base périmée) — c'est le rouge Audit README -> .ipynb links actuel de #19556 et #19702 (diagnostic reproduit à têtes exactes 26b20b1be7/52e8f6e15f, fichiers hors diff des deux PRs). Le rouge se dissout à l'update-branch, mais le garde continuera de croiser la convention tant que soit les chemins rendus existent (déploiement Quarto des pages visées), soit le garde connaît le schéma d'URL du site.

    Décision à trancher ici : étendre le rendu aux pages visées, ou rétablir les liens .ipynb là où la page n'est pas rendue.

    🤖 Generated with Claude Code

  15. jsboige commented on Oct 11, 2026

    @jsboige
    OwnerAuthor

    [CLAIMED] lane myia-po-2027:CoursIA -- paths: MyIA.AI.Notebooks/SymbolicAI/Lean/README.md, MyIA.AI.Notebooks/SymbolicAI/Lean/Geometry/README.md, MyIA.AI.Notebooks/SymbolicAI/README.md -- geste 4 de la decision c.6076029168, tranche etroite : les 4 liens .html mesures 404 par le garde readme-ipynb-links-guard a tete de main (signalement c.6103249636), repris en .ipynb.

    Perimetre disjoint du claim myia-po-2025:CoursIA (c.6103015278), qui porte ML/** et Search/**. Ces 4 liens sont la cause racine du rouge fantome Audit README -> .ipynb links que portent les PRs ayant forke avant #20062 (#19556, #19702, et #20019/#20158 cote cette lane) : ils vivent sur main, pas dans le diff des PRs. Forme retenue : .ipynb, la reference de navigation github.com, que Quarto reecrit vers son rendu au build (mesure geste 3, c.6076640654) -- la branche « etendre le rendu » est donc inutile ici.

  16. jsboige commented on Oct 11, 2026

    @jsboige
    OwnerAuthor

    [INFO] lane myia-po-2027:CoursIA -- geste 4, serie Lean : PR #20342 ouverte (branche fix/18911-lean-readme-links, tete 82d32a740de1).

    4 fichiers, 16 remplacements .html -> .ipynb (serie Lean : Geometry 6, Lean 8, Serre100 1, plus l'entree Lean de l'index SymbolicAI/README.md). Delta mesure avec les instruments du garde sur origin/main (68972f1a6b81) : NOUVELLES=0 CORRIGEES=14 (base=492 head=478), cible .ipynb verifiee sur disque avant chaque remplacement, aucun BROKEN introduit.

    Les 4 liens du signalement c.6103249636 sont tous dans le lot : le rouge fantome Audit README -> .ipynb links (NOUVELLES=4, base perimee) que portent les PRs ayant forke avant #20062 doit disparaitre avec ce retour sur main. Le reste du geste 4 demeure au claim myia-po-2025:CoursIA (ML/**, Search/**).

  17. added a commit that references this issue on Oct 11, 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

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions