Skip to content

docs(readme,#3973): présenter les trois vitesses de lecture dès le README principal - #17781

Merged
myia-ai-01 merged 2 commits into
mainfrom
docs/root-readme-reading-speeds
Sep 25, 2026
Merged

myia-ai-01 merged 2 commits into
mainfrom
docs/root-readme-reading-speeds

Conversation

@myia-ai-01

Copy link
Copy Markdown
Collaborator

Grain: LIGHT/docs -- lane myia-ai-01:CoursIA -- prev: LIGHT/docs #17779

Résumé

Le README principal présente maintenant dès « Commencer ici » le principe des parcours à plusieurs vitesses. Il invite aussi le lecteur à choisir comment il navigue.

  • Choisir sa vitesse de lecture : une table de trois lignes. Le parcours principal suit les numéros nus, l'approfondissement passe par les lettres d'un palier, la recherche par les sous-séries et les sections « Pour aller plus loin ». S'y ajoutent le conseil de premier passage (les numéros nus sans ouvrir une lettre) et la règle des jumeaux Python, C# et Lean. La section annonce enfin la forme que les READMEs de série adoptent progressivement.
  • Choisir son principe de navigation : les trois chemins de l'ancienne liste deviennent quatre modes explicites. On navigue par série à sa vitesse (le mode par défaut), par itinéraire narratif (PARCOURS.md), par contrainte d'infrastructure (parcours.qmd) ou par inventaire (le catalogue).
  • Cohérence dans le fichier : la philosophie pédagogique ne parle plus d'« ordre de lecture ». Elle renvoie au même principe.

Pourquoi

C'est la face lecteur de la refonte décrite dans le body de #3973 (2026-09-25) et de la doctrine de gradation de #5081. Les noms de fichiers portent déjà deux dimensions : les numéros nus pour l'arc, les lettres pour la profondeur. Le lecteur n'en était averti nulle part. La forme que les READMEs de série doivent prendre est portée par #17779 (gabarit de l'agent).

Vérifications

  • check_prose_quantitative_claims.py --diff origin/main...HEAD : [OK] aucun compteur quantitatif en prose.
  • Les ancres internes #séries-de-notebooks, #mise-en-route et #choisir-sa-vitesse-de-lecture existent dans le fichier.
  • Les cibles PARCOURS.md, parcours.qmd et COURSE_CATALOG.generated.md existent. La description de parcours.qmd reprend ses trois niveaux réels : local sobre, .NET et Lean, GenAI complet.
  • Aucun bloc CATALOG-STATUS touché, catalogue byte-identique.

See #3973 · See #5081

🤖 Generated with Claude Code

…ADME principal

Le README racine invite desormais le lecteur a choisir sa vitesse de
lecture (parcours principal par numeros nus, approfondissement par
lettres, recherche par sous-series) et son principe de navigation (par
serie, par itineraire narratif, par contrainte d'infrastructure, par
inventaire). La phrase de la philosophie pedagogique qui parlait
d'« ordre de lecture » renvoie a ce principe.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added paragraph-length Paragraph > 2000 chars (wall-of-text, #15405). Resorb before merge. variation-light-cap-reached Lane ayant deja merge une LIGHT aujourd'hui (cap G-VAR-2 atteint) labels Sep 25, 2026
@github-actions

Copy link
Copy Markdown
Contributor

G-VAR-2 light cap reached (advisory, non bloquant).
La lane myia-ai-01:CoursIA a deja consomme son budget LIGHT du jour (#17686 (merge a 2026-09-25T00:57:01Z)).
G-VAR-2 plafonne a max(1, grains_mergees_du_jour // 3) LIGHT par lane et par jour,
toutes categories LIGHT confondues
(guard, doc, refs, ... partagent un seul budget) :
c'est un RATIO, pas un plafond plat. La decision de merge reste au coordinateur.

@github-actions github-actions Bot added variation-genre-cap-exceeded light_genre > cap partage G-VAR-2 (#10020, advisory) variation-genre-mismatch declared genre != genre infere depuis les chemins du diff (#10020, advisory) labels Sep 25, 2026
@github-actions

Copy link
Copy Markdown
Contributor

G-VAR-2/3 GENRE signals (advisory, non bloquant, #10020).
La lane `myia-ai-01:CoursIA` voit ces signaux actifs sur les mergees du jour (UTC 2026-09-25) :

  • CAP-EXCEEDED-BY-GENRE : light_genre > cap partage G-VAR-2 (tally : declared=3 genre=3 cap=2)
  • GENRE-MISMATCH : declared genre != genre infere depuis les chemins du diff

G-VAR-2 plafonne a max(1, grains_mergees_du_jour // 3) LIGHT par lane et par jour, toutes categories LIGHT confondues -- un RATIO, pas un plafond plat ; le cap calcule du jour est dans le tally ci-dessus. G-VAR-3 interdit deux genres LIGHT consecutifs. Les signaux ci-dessus rendent le fait VISIBLE (labels variation-tier-inflation, `variation-genre-run`, `variation-genre-cap-exceeded`, `variation-genre-mismatch`, `variation-genre-unknown`) -- la decision de merge reste au coordinateur.

@github-actions github-actions Bot added the trivial-diff-advisory Diff trivial : grain META mecanique sans fournee ni exception ecrite (#15740) label Sep 25, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Trivial-diff advisory (#15740, non bloquant).
genre docs dans la famille META (docs/guard/ledger/readme/test) + diff de 29 lignes changees (<= 100) + aucune exception ecrite dans le body : le litmus de la trivialite (une douzaine d'instances scannees a la suite) est credible. Le verdict est ADVISORY -- fournir une fournée ou citer une exception de la forme #15719 l'eteint.
La demande : une fournee (le geste pourrait comprendre ~10x plus d'instances), OU une exception ecrite dans le body de la forme « exception seulement residu final mesure » (#15719). Editer le body re-deroule cet organe et retire le label.

…Theory

Le paragraphe de presentation de GameTheory nommait deux entreprises
pour illustrer les encheres VCG. La surface publique du depot ne nomme
pas d'acteurs economiques vivants : l'exemple garde son ordre de
grandeur sans eux.

Co-Authored-By: Claude-Code <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@myia-ai-01

Copy link
Copy Markdown
Collaborator Author

Commit ajouté (e626851) : le paragraphe GameTheory du README racine nommait deux entreprises pour illustrer les enchères VCG. Il les retire, en gardant l'ordre de grandeur. Le défaut était déjà sur main ; il est corrigé ici parce que cette PR réécrit le même fichier.

Dépendance : #17797 (README GameTheory) renvoie à l'ancre #choisir-sa-vitesse-de-lecture introduite par cette PR. Il faut donc merger cette PR avant #17797.

@jsboige

jsboige commented Sep 25, 2026

Copy link
Copy Markdown
Owner

[ADJOINT PREFLIGHT]
schema: 1
lane: myia-po-2026:CoursIA-3
pr: 17781
head: e626851
complete: true
body: read
comments-reviewed: 4
reviews-reviewed: 0
threads-reviewed: 0
threads-unresolved: 0
surfaces-sha256: 61f4fa255da55ce3d6144ad9fbf67c7acb23454992c7442c03d795c0721991da
diff-files: 1
diff-additions: 25
diff-deletions: 6
checks: blocked-via-dwell
b0: blocked
scope: pass
domain: not-applicable
verdict: BLOCKED
[/ADJOINT PREFLIGHT]

Aucun dossier anterieur. PR gate DWELL -- tete du 2026-09-25T09:52:43Z, minuteur 120 min, ecoule a 2026-09-25T12:07:00Z. 1 fichier (README racine, +25/-6, ancre #choisir-sa-vitesse-de-lecture) ; 4 commentaires et 0 review. B.0 rc=0 aucun nit non leve parmi les commentaires evalues ; 1 commentaire non evalue A RELIRE (commit e626851 retire deux noms d'entreprises illustrees par les encheres VCG -- la justification est dans le commentaire). Aucun defaut de substance : plancher mecanique, c'est la candidate qui attend, pas la lane. Pas de re-push recommande (un re-push remet le plancher a zero).

@github-actions

Copy link
Copy Markdown
Contributor

Path-collision (organ #13359/#13615)

Cette PR #17781 (docs(readme,#3973): présenter les trois vitesses de lecture dès le README principal) touche au moins un chemin de fichier aussi modifie par d'autres PRs ouvertes. Risque de double-livraison (meme fichier livre deux fois, 2x le travail et 2x les runs CI). Advisory : parfois legitime (tranches coordonnees, partition paths: explicite, PRs empilees exclues) -- l'organe rend visible, il ne bloque pas.

@jsboige

jsboige commented Sep 25, 2026

Copy link
Copy Markdown
Owner

[ADJOINT PREFLIGHT]
schema: 1
lane: myia-po-2026:CoursIA-3
pr: 17781
head: e626851
complete: true
body: read
comments-reviewed: 6
reviews-reviewed: 0
threads-reviewed: 0
threads-unresolved: 0
surfaces-sha256: ed5f3be937fb20c4a92c1988f3d94acd6b4ca55a2360348f3632968e48a1a942
diff-files: 1
diff-additions: 25
diff-deletions: 6
checks: latest-wins-green
b0: clear
scope: pass
domain: not-applicable
verdict: READY
[/ADJOINT PREFLIGHT]

Re-stamp secretaire c.141 -- tiers au titulaire (Tell c.111 strict). PR gate SUCCESS post-DWELL (rerun 36120908098 @13:27:12Z). B.0 rc=0 OK. Lane secretaire myia-po-2026:CoursIA-3. Fix emetteur c.141 : stderr separe, ligne 1 gardee.

@myia-ai-01
myia-ai-01 merged commit 4a6d77f into main Sep 25, 2026
21 of 23 checks passed
myia-ai-01 pushed a commit that referenced this pull request Sep 26, 2026
…t ne perime plus un dossier (#17880)

#16931 avait neutralise la REECRITURE en place des commentaires marker-gardes
(hash sur le marqueur seul) mais pas leur premiere pose posterieure au
dossier : l'arrivee d'une PR voisine declenchant l'organe PR-PATH-COLLISION
sur les README partages perimait le dossier sans que le fond bouge (mesure
2026-09-25 : dossiers de #17781/#17797 perimes a 13:02Z par la pose du bot
seule).

_is_bot_advisory_pose : predicat conjonctif auteur (github-actions[bot],
suffixe reserve aux comptes d'app) ET marqueur _BOT_MARKER_GUARDS en tete de
corps, neutralise la row dans le decompte foreign d'evaluate_with_dossier.
L'auteur compte, pas le texte seul : un tiers qui recopie le marqueur perime
toujours le dossier. La liste reste dans le code, jamais dans le dossier.

Mesure du pool (25/09, 27 PRs ouvertes a dossier) : 10 NO-DOSSIER
"discussion changed" en semantique pre-fix ; 2 dus au SEUL motif (#17781,
#17797, verdict redevenu lisible BLOCKED) ; 1 (#17787) ou le motif s'ajoutait
a une peremption reelle (head/diff stale) ; 7 ou "discussion changed"
n'etait jamais la cause unique.

Tests : 3 nouvelles (pose bot ne perime pas / commentaire humain perime /
marqueur recopie par un tiers perime) -- 94/94, voisines 172/172.

Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
myia-ai-01 pushed a commit that referenced this pull request Oct 3, 2026
…orme #3973) (#18997)

* docs(readme,#3973): Tweety README en parcours a plusieurs vitesses (forme #3973)

Grain: MED/docs -- lane myia-ai-01:CoursIA-2 -- prev: MED/guard #18991

## Resume

Le README de la serie Tweety presentait chaque notebook (12 Python + 18 C# + 7 Lean companion = 38 racine + 1 probe) et chacune de ses accretions comme une etape d'une lecture sequentielle unique, dans une seule table Structure de 47 lignes. Un lecteur qui voulait le parcours leger devait trier lui-meme des lignes ou les lettres, les jumeaux C#, les laboratoires Lean et les extensions se melaient aux numeros nus. Cette PR le reorganise selon la forme #3973 et l'arbitrage du mainteneur du 25/09, en coherence avec le hub #17800 (SymbolicAI famille a plusieurs vitesses) et la feuille patron #17797 (GameTheory README en parcours a plusieurs vitesses).

## Nouvelle structure

| Section | Public | Contenu |
|---|---|---|
| Ouverture, **Comment lire ce README** | Decouverte | Les trois vitesses, avec renvoi a la section racine (#17781), et la **grammaire des noms de fichiers** (`<NN>[<lettre>]-<Titre>-<Noyau?>`) |
| Pourquoi, Presentation | Decouverte | L'existant, inchange |
| **Parcours principal** | Decouverte, Licence | Numeros nus 01 a 12. Une ligne par palier. Les lettres apparaissent uniquement dans les liens courts des approfondissements. |
| **Approfondissements** | Licence, Recherche | Une sous-section par palier (02, 03, 04, 05, 06, 07, 08/09, 10/11). Le tableau par lettre dit ce qu'elle ajoute. |
| Sous-serie Argumentation -- Argumentum | Recherche | Pointeur vers Argument_Analysis et le sous-module ; pas d'inventaire redondant |
| Le reste (En quoi chaque notebook est unique, Pont symbolique/statistique, Echelle causale, Concepts cles, Domaines, Quick Start, Pre-requis, Architecture, Outils externes, Limitations, Modules, Validation, FAQ, Versions, Ressources, Ponts, Conclusion, Statistiques catalogue, Ecosysteme MCP) | mixte | Conserve tel quel |

Aucun total ni compte n'est ecrit en prose pour les notebooks : le compte et la maturite vivent dans le bloc CATALOG-STATUS (lignes 1-10 inchangees, verifie par diff vide).

## Corrections de fond au passage

- Renommage des liens dans la table : `Tweety-1-Setup` -> `Tweety-01-Setup-Python` (et idem pour 2-9, 10, 11). Les fichiers s'appellent deja `-Python` depuis #16231 ; la table disait l'ancien nommage.
- Palier 7 : les entites 7a et 7b etaient dans la meme ligne de phase ("Phase 4 : Frameworks avances et probabilistes (Notebooks 7a-7b, ~1h)"), sans mention que 7b est un approfondissement. Le parcours principal expose 7 (07a) ; 7b rejoint les approfondissements.
- Liens `Tweety-5-Abstract-Argumentation-Csharp.ipynb` -> cible reelle `Tweety-5-Abstract-Argumentation-CSharp.ipynb` (C# majuscule) sur disque ; idem corrections silencieuses sur 02-Basic-Logics-CSharp, 06-04-Structured-Argumentation-CSharp, 07a, 07b, 08-Agent-Dialogues-CSharp, 09-Preferences-CSharp, 10-MLN-Csharp, 11-Causal-CSharp. Les chemins de la table d'origine etaient coherents avec la cible reelleee (casse-preservant), j'ai preserve cette convention.
- Mention du do-calculus etait dans la presentation sans renvoyer aux notebooks partenaires (Infer.NET, PyMC, ICT). Les liens inter-series ont ete preserves.

## Dependances

- **Merger apres #17781** : le renvoi `../../README.md#choisir-sa-vitesse-de-lecture` pointe l'ancre introduite par #17781. Si cette ancre n'existe pas encore au moment de la revue, le lien GitHub sera mort mais le fichier reste local-coherent.
- Le hub SymbolicAI (#17800) liste deja le parcours leger de Tweety (`01 a 12`) ; cette PR est alignee avec cette description. Aucune modification du hub n'est requise.

## Validation

- Liens relatifs : tous resolus. Chaque notebook racine (12 Python) et chaque lettre (12+ lettres appraissant dans les tables d'approfondissement) est lie au moins une fois ; aucune cible absente.
- `python scripts/check_docs_links.py --check --base origin/main` : `OK: No new broken links. (0 pre-existing, 8004 total)`.
- `python scripts/notebook_tools/check_prose_quantitative_claims.py --diff origin/main --strict` : `[OK] aucun compteur quantitatif en prose`, rc=0.
- `python scripts/notebook_tools/check_link_label_agreement.py --json` : 0 finding sur Tweety/README.md (les findings sur les notebooks eux-memes -- notamment `Tweety-3c-ML` qui pointe `Tweety-3-ModalLogic-Csharp.ipynb` -- sont pre-existants et sortent du scope de cette PR, le perimetre etant le seul fichier README).
- Lignes 1-10 (titre, navigation, CATALOG-STATUS) identiques a origin/main (diff vide apres conversion CRLF->LF).
- Pas de notebook modifie : aucune re-execution requise.

See #3973, #17781, #17797, #17800, #16231

🤖 Generated with [Claude Code](https://claude.com/claude-code)

* fix(docs,#18997): aligner 4 chemins CSharp casses sur la convention disque (Csharp)

Le check CI docs-link (Linux, case-sensitive) a detecte 4 liens casses sur le
README Tweety : les paths utilisaient -CSharp.ipynb (majuscule) pour les paliers
3-ML, 4-BR, 5 et 11 alors que les fichiers sur disque sont en -Csharp.ipynb
(minuscule). La convention du dossier est mixte selon le palier (CSharp majuscule
pour 02, 02b, 02c, 06, 07a, 07b, 08, 09 ; Csharp minuscule pour 3, 4, 5, 10, 11),
reflet de la normalisation #16231 en cours. Cette PR aligne les 4 chemins casses
sur la convention reelle du disque sans toucher au label (qui etait deja en
Csharp minuscule).

Cause : la table d'origine avait des liens avec label et path inconsistants. Mon
remaniement a preserve le label et unifie une partie des paths, mais 4 chemins
sont restes en CSharp majuscule alors que le filesystem canonique (Linux CI)
porte Csharp minuscule pour ces paliers-la. Verifie localement, le
check_docs_links local (Windows NTFS case-insensitive) rend OK ; seule la CI
Linux case-sensitive a signale les 4 casses.

Verification : check_docs_links.py 8004 liens, 0 casses apres PATCH.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

paragraph-length Paragraph > 2000 chars (wall-of-text, #15405). Resorb before merge. trivial-diff-advisory Diff trivial : grain META mecanique sans fournee ni exception ecrite (#15740) variation-genre-cap-exceeded light_genre > cap partage G-VAR-2 (#10020, advisory) variation-genre-mismatch declared genre != genre infere depuis les chemins du diff (#10020, advisory) variation-light-cap-reached Lane ayant deja merge une LIGHT aujourd'hui (cap G-VAR-2 atteint)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants