Skip to content

docs(semanticweb): auditer le README après l'ajout de SW-16 #16904

Description

@jsboige

Requalification — arbitrage user du 2026-09-24 (fait foi sur le reste de ce body)

La première livraison, #17029, a mis à jour les totaux (26→27, 14→15) et a été revertée par #17632. Le périmètre de cette issue devient :

À livrer — le corps du README qui présente les notebooks récents :

  • une section #### pour SW-16-Python-ProofCarryingOntologies (aujourd'hui absente), au niveau de détail des sections SW-11 à SW-13 : ce que le notebook démontre, ses outils (Lean, rdflib…), ses points clés, sa place dans le fil de la série ;
  • l'enrichissement de SW-14 (une seule phrase aujourd'hui, marquée « Enregistrement rétroactif ») et, si besoin, de SW-15, au même niveau ;
  • SW-14/15/16 intégrés aux Concepts clés, au tableau de la Partie 4, aux Acquis d'apprentissage, aux Parcours alternatifs pertinents, au Quick Start (« SW-8 a SW-13 ») et à la Structure des fichiers ;
  • un contenu fidèle aux notebooks : lire chaque notebook avant d'écrire, ne rien promettre qu'il ne tient pas.

Hors périmètre — ne pas toucher :

Les critères d'acceptation ci-dessous qui portent sur les comptes (« comptages par sous-dossier reproductibles », « réconciliation disque/prose/catalogue ») sont caducs. Restent valides : liens de navigation valides, rendu Markdown vérifié, catalogue byte-identique à main.


Constat

La PR #16900 ajoute SW-16-Python-ProofCarryingOntologies.ipynb sans modifier le README de la série afin de conserver un périmètre atomique. Après merge, le README actuel deviendra obsolète : il annonce encore « SW-1 à SW-15 » et « 14 notebooks Python », et SW-16 ne figurera pas dans la table de navigation.

Travail attendu

Auditer le fichier MyIA.AI.Notebooks/SymbolicAI/SemanticWeb/README.md en entier contre le disque, puis corriger dans une PR dédiée et cohérente :

  • le périmètre annoncé de la série ;
  • les comptes Python/.NET/Lean réellement mesurés ;
  • la table de navigation et les durées, avec une ligne SW-16 ;
  • les listes, arbres et ventilations éventuellement devenus obsolètes ailleurs dans le fichier ;
  • la cohérence disque ↔ prose ↔ bloc CATALOG-STATUS, sans régénérer manuellement le catalogue automatisé.

Critères d'acceptation

  • audit fichier-entier documenté dans le body de PR ;
  • comptages par sous-dossier reproduisibles ;
  • réconciliation explicite disque/prose/catalogue ;
  • liens de navigation valides ;
  • aucune édition des fichiers COURSE_CATALOG.generated.* sur la branche feature ;
  • validation des liens et du rendu Markdown après correction.

Issue de suivi ouverte en réponse au nit de review NanoClaw sur #16900. La livraison du notebook reste dans #16900 ; cette issue porte exclusivement l'audit README de série.

Activity

  1. jsboige commented on Sep 20, 2026

    @jsboige
    OwnerAuthor

    [INFO] mesure de la porte — #16904 est gated par le merge de #16900 (SW-16 absent de main)

    Mesure firsthand du 2026-09-20 (lane myia-po-2023:CoursIA, sur origin/main) :

    Constat Valeur mesurée
    SW-16-Python-ProofCarryingOntologies.ipynb sur main absent (git ls-tree -r --name-only origin/main | grep -i SW-16 -> vide)
    #16900 OPEN, mergeStateStatus=CLEAN, head f989458f
    SW-*-Python.ipynb 14
    SW-*-CSharp.ipynb 12
    total SW-*.ipynb 26
    RDF.Net-Legacy/RDF.Net.ipynb 1 (26 + 1 = 27, ce que déclare le bloc CATALOG-STATUS)
    prose l.73 « Suivez les notebooks SW-1 à SW-15 »
    arbre de structure (l.542) se termine à SW-15-Python-Coup-Argumentatif.ipynb

    Pourquoi je ne livre pas l'audit maintenant : les corrections que l'audit doit apporter sont exactement celles qui dépendent de SW-16 (périmètre « SW-1 à SW-16 », ligne de table, arbre, compteur Python 14 -> 15, durées). Les écrire pre-merge produirait une ligne de navigation vers un fichier inexistant — or l'acceptation exige « liens de navigation valides », et le dépôt porte un garde de liens (scripts/check_docs_links.py). Faire la moitié maintenant, c'est livrer un README faux dans l'autre sens et repayer la passe au merge.

    Ce que la mesure donne au repreneur : le reste du fichier est déjà cohérent avec le disque aujourd'hui — le chiffre « 14 notebooks Python » (cité par l'issue) est exact sur main, et CATALOG-STATUS (27) égale 26 SW-* + 1 legacy. La passe post-merge est donc ciblée : les 5 surfaces listées ci-dessus, pas un audit exploratoire.

    WAIT_FOR : merge de #16900. RESUME_WHEN : SW-16-Python-ProofCarryingOntologies.ipynb présent sur origin/main (alors git ls-tree -r --name-only origin/main | grep -i SW-16 rend 1 ligne, et SW-*-Python passe à 15). Lane qui reprend : la première disponible — je ne pose pas de claim sur un grain dont la porte n'est pas ouverte.

  2. jsboige commented on Sep 20, 2026

    @jsboige
    OwnerAuthor

    [CLAIMED] lane myia-po-2024:CoursIA-2 — audit README SemanticWeb fichier-entier, puis PR dédiée cohérente (catalogue byte-identique main, scope = #16904 strict)

  3. added a commit that references this issue on Sep 24, 2026
  4. added 2 commits that reference this issue on Sep 24, 2026
  5. added a commit that references this issue on Sep 24, 2026
  6. added
    candidate-deliveredReferenced by a merged PR with no post-merge activity -- candidate for close triage (#10466)
    on Sep 25, 2026
  7. added a commit that references this issue on Sep 29, 2026
  8. myia-ai-01 commented on Oct 5, 2026

    @myia-ai-01
    Collaborator

    Urne delivered : ce n'est pas encore livré, je la rends au tapis (ai-01, vérifié sur origin/main le 05/10)

    La pièce maîtresse de la requalification du 24/09 manque : la section #### qui présente SW-16 (au niveau de SW-11 à SW-13) n'existe pas dans le README de main, et aucun commit ne l'a jamais posée. Il reste aussi le commentaire Quick Start (l. 403), qui dit encore « SW-8 a SW-13 », et les parcours alternatifs, qui n'intègrent pas SW-14 à SW-16.

  9. removed
    candidate-deliveredReferenced by a merged PR with no post-merge activity -- candidate for close triage (#10466)
    on Oct 5, 2026
  10. myia-ai-01 commented on Oct 6, 2026

    @myia-ai-01
    Collaborator

    [CLAIMED] lane myia-po-2024:CoursIA-2 -- tapis central 2026-10-06 (repartition ai-01, file a arc coherent) : Livrer la PR docs : section #### SW-16 + enrichissement SW-14/15 + intégration Concepts clés/Partie 4/Acquis/Parcours/Quick Start, contenu fidèle aux notebooks lus beforehand, totaux laissés au catalogue.. Rendre la main par [DELIVERED] ou [RELEASED].

  11. jsboige commented on Oct 6, 2026

    @jsboige
    OwnerAuthor

    [DELIVERED] lane myia-po-2024:CoursIA-2 (c.52) — PR #19507 — scope strict #16904

    Livré :

    • Section #### SW-16-Python-ProofCarryingOntologies au niveau des sections SW-11/12/13 (concept, outils, points clés, pont Lean)
    • SW-14 enrichi (ontologie jouet, pipeline compose, coup nul, provenance) — mention « enregistrement retroactif » retiree
    • SW-15 enrichi (conventions de nommage Argumentum, reification classique + PROV note rdflib 7.6)
    • Acquis d'apprentissage : section « Extensions (Bonus Python) » items 8/9/10
    • Parcours : nouveau « Parcours extensions (~3h, bonus Python) »
    • Quick Start : scope Python « SW-8 a SW-16 », note binaire open-ontologies 58 Mo + SHA256
    • Structure des fichiers : commentaire SW-14 aligne

    Hors perimetre respecte :

    • CATALOG-STATUS byte-identique a main (aucune ligne du diff ne touche le bloc catalogue)
    • COURSE_CATALOG.generated.* non touche
    • Aucune mise a jour manuelle de totaux
    • Pas de regeneration du catalogue par cette lane

    Diff : 1 file changed, 45 insertions(+), 7 deletions(-) (commit dba9a79c92)

    Verification substance avant ecriture (Tell c.18590) :

    • SW-14, SW-15, SW-16 dumpes depuis origin/main via git show + parsing JSON
    • Chaque notebook lu firsthand (SW-15 conclusion 4 gestes, SW-16 sections 1-9) avant redaction
    • Faits non verifiables non promis (bascule {RA4} -> {RA3, RA5} prise a la cellule 17 du notebook)
    • Lien externe open-ontologies pointe la release v1.4.0 taggee et SHA256-ee

    Refs #16904, PR #19507.

  12. added 6 commits that reference this issue on Oct 7, 2026
  13. added a commit that references this issue on Oct 8, 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