Repository navigation
READMEs : 459 liens .html morts (404 github) sur 46 READMEs -- remplacer par la forme .ipynb (arbitrage #18911) #20549
Description
Constat (signalé en cours, EPF, 13/10)
Les README du dépôt portent des liens vers des notebooks en .html (ex. Search/Part1-Foundations/README.md) : sur github.com ces liens partent en 404 — les rendus Quarto vivent uniquement sur le déploiement Pages et ne sont jamais commis dans l'arbre. La navigation de référence sur github.com est le viewer .ipynb (arbitrage #18911 du 2026-10-09 : un lien .html dont la cible n'est pas commise = 404 ; la forme de référence est .ipynb, le site Quarto adapte à la construction).
Ampleur mesurée (main, 13/10)
python scripts/regen_quarto_render.py --check-readme-links : 459 liens morts uniques sur 46 READMEs.
| Sous-arbre | Liens morts |
|---|---|
| ML | 331 |
| Search | 99 |
| RL | 58 |
| SymbolicAI | 43 |
| GenAI | 42 |
| Probas | 17 |
| Complexity | 7 |
| QuantConnect | 6 |
| IIT | 3 |
| Compression | 1 |
La garde readme-ipynb-links-guard.yml existe déjà mais ne rougit que sur les violations NOUVELLES (arbitrage #18911) : ce backlog historique (616 mesurés le 2026-10-09, 459 aujourd'hui) est signalé sans bloquer — d'où sa persistance.
Fix
Remplacement mécanique .html → .ipynb sur les liens relatifs vers notebooks. Contrôle mesuré à l'instant : 459/459 cibles ont leur .ipynb présent à côté — zéro cas piège (aucun lien vers un html sans jumeau ipynb). Les liens absolus (http/anchor) sont hors scope.
Déroulé :
- Search (99 liens, 6 READMEs) + SymbolicAI (43 liens, 3 READMEs) — PR immédiate (usage en cours)
- ML (331 liens) — sweep dédié
- RL (58) + GenAI (42) + Probas (17) — sweep dédié
- Résiduel (Complexity 7, QuantConnect 6, IIT 3, Compression 1) — sweep final, puis vérification
--check-readme-linksà 0 HTML_404
Impact pédagogique
Un étudiant qui clique un lien de README depuis github.com tombe sur une 404 — la table de navigation d'une série est sa principale porte d'entrée.
Activity
Fix(readme,#20549): sweep complet -- 312 liens restants (ML, RL, GenA…
Fix(readme,#20549): Search + SymbolicAI -- 189 liens .html morts remp…
Fix(readme,#20549): sweep complet -- 312 liens restants (ML, RL, GenA…
Fix(readme,#20549): ancre HTML 2.4b-AdaBoost en .ipynb (angle mort sc…
jsboige commentedon Oct 13, 2026
Complément classe d'ancres HTML (audit croisé du 13/10) : le scanner
--check-readme-linksne lit que les liens markdown — les ancres<a href="...html">sont un angle mort. Recensement fleet-wide : 1 occurrence (MyIA.AI.Notebooks/ML/DataScienceWithAgents/02-ML-Cours/README.md:114), corrigée dans #20550 au commita98651d8d4(même forme.ipynb). Vérification post-fix : 0 ancre locale.htmlrestante sur tous les READMEs de l'arbre. Si le garde veut couvrir la classe à l'avenir, l'extension du scanner est l'organe (proposition laissée à l'arbitrage coordinateur — je ne l'ajoute pas dans #20550, déjà au plafond de fichiers).Fix(readme,#20549): liens .html morts remplaces en .ipynb sur tout le…