Skip to content

[consolidation] docs/ : index 90/135, detail.md manquants, drift READMEs multi-series (V3) #13748

Description

@jsboige

docs/ : index incomplet, orphelins, marqueur archive (V3)

See #13737. Source : agent docs/ (RAPPORTE sauf mention ; clone shallow — dates git inobservables, l'obsolescence se juge au contenu).

Index README docs/

  • 90/135 fichiers live référencés ; 45 manquants dont 4 *-detail.md explicitement cités par les rules .claude/rules/*.md (liens morts dans le harnais) → priorité 1 : créer ou réparer ces 4.
  • 21 docs orphelins (aucune référence entrante) → relier depuis l'index ou archiver.

docs/archive/

  • 325 fichiers, 54 % du volume docs, ~580 liens cassés attendus (figée à dessein).
  • Action : ajouter un bandeau d'en-tête « ARCHIVE — contenu figé, liens non maintenus » au README de docs/archive/ (pas de réparation de liens, pas de suppression).

Drift README multi-séries (même motif : comptes main-édités vs catalogue)

  • RL : 23 affichés vs 25 réels · Probas : 23 vs 24 · GameTheory : 89 vs 90 · docker-configurations : 11 services listés vs 19 réels · GenAI/Video/02-Advanced/README.md : 5 vs 7 (02-6 MiniMax H3 + 02-7 CogVideoX omis) · QC projects/ : 112/116/118 dans 3 fichiers du même dossier (README, STRATEGIES_DETAIL, docs/qc/qc-strategies-status).
  • Action par README : audit fichier-entier (règle E) + réconcilier disque ↔ CATALOG-STATUS ↔ prose. Le marqueur CATALOG-STATUS reste byte-identique à main (catalog-cron régénère).

GenAI docs

  • INDEX.md racine GenAI périmé vs README (double source de vérité) → déprécier INDEX.md (pointeur vers README) ou le régénérer.
  • VALIDATION_SUMMARY.txt / VALIDATION_TEXTE_FINAL.md stale (10 vs 29 notebooks) → actualiser ou archiver.
  • tutorials/ jamais référencé nulle part → relier ou archiver.
  • _research/qwen_sae_inventory.md : mal parenté (sujet ICT) → déplacer sous IIT ou relier.

Autres

  • mcp-maintenance 6 docs d'incidents 2025 → docs/archive/mcp-incidents-2025/ (avec l'issue scripts/).
  • 3801-sota-axe2.md 2782 lignes → découper par famille si consulté (optionnel, faible priorité).
  • QC docs/audits/ 6 rapports one-shot datés : convention de nom OK si one-shot assumé — ajouter 1 ligne dans docs/qc/quantconnect.md.

Acceptance

  • Index docs/ référence 100 % des live (ou les orphelins sont archivés)
  • Les 4 *-detail.md cités par les rules existent
  • Bandeau archive posé · chaque README drifté réconcilié

Activity

  1. jsboige commented on Sep 2, 2026

    @jsboige
    OwnerAuthor

    [CLAIMED] lane myia-po-2026:CoursIA-2 -- completion de l'index docs/README.md : rendre atteignables les 42 docs live absents de l'index (mesure firsthand sur main courant) -- paths: docs/README.md

    (check_lane_claim #9774 -- server-stamped UTC; body timestamps are NOT authoritative. Release with [RELEASED] when your PR lands.)

  2. jsboige commented on Sep 2, 2026

    @jsboige
    OwnerAuthor

    Mesure firsthand sur main courant — priorité 1 réfutée, priorité 2 livrée par #14377

    Le body de cette issue se déclare RAPPORTE, produit sur un clone shallow (« dates git inobservables, l'obsolescence se juge au contenu »), et date du 2026-08-30. Mesuré aujourd'hui sur main avant d'adopter les chiffres.

    Priorité 1 — « 4 *-detail.md cités par les rules : liens morts dans le harnais » : faux sur main courant

    Un lien mort dans .claude/rules/*.md ou CLAUDE.md serait un défaut réel — ces fichiers sont auto-chargés à chaque session. Parcours de tous les liens markdown relatifs qui en sortent :

    Sources examinees      : 30 (29 rules + CLAUDE.md)
    Liens relatifs mesures : 218
    Cibles inexistantes    : 0
    

    Aucun lien mort, sur 218 liens. La case d'acceptance « Les 4 *-detail.md cités par les rules existent (ou les liens sont retirés) » est donc déjà satisfaite — soit les fichiers ont été créés depuis la rédaction, soit le clone shallow ne les voyait pas. Je la coche ici plutôt que de laisser un worker suivant chasser un défaut inexistant.

    Priorité 2 — « 90/135 live référencés ; 45 manquants » : le 90 est exact, le reste demande de nommer ce qu'on compte

    Trois notions différentes étaient confondues sous « manquant ». Mesurées séparément :

    Notion Mesure
    Live sous docs/ hors archive/ 146 (le body dit 135)
    Cités directement par docs/README.md 90 — reproduit exactement, au fichier près
    Atteignables en transitif depuis l'index 104
    Cités par ≥1 fichier du dépôt (entrants repo-wide) 111
    Orphelins réels (aucun entrant nulle part) 35
    Non atteignables depuis l'index 42

    Le « 90 » se reproduit exactement : la méthode du body était bien « référencé directement par docs/README.md ». Mais « manquant de l'index » ≠ « orphelin », et la citation directe n'est pas la bonne métrique d'acceptance : un index de sous-répertoire (lean/README.md, ict/README.md, archive/INDEX.md) est une structure légitime, donc un document à deux sauts est dans l'index. La cible « 100 % des live » se mesure en atteignabilité transitive — d'où 42, et non 45.

    Angle mort à écrire plutôt qu'à compter : docs/harness/global-rules-detail.md ressort orphelin de tout parcours limité à ce dépôt, alors qu'il est cité depuis le ~/.claude/CLAUDE.md global. Un lien entrant extérieur au repo est invisible à un walk repo-scopé. C'est consigné dans son entrée d'index.

    Livré

    PR #14377 — 42 entrées ajoutées à docs/README.md, chacune rédigée depuis le H1 et la première ligne de prose du fichier visé. Après : 146 live, 146 atteignables, 0 restant. La ligne d'auto-description périmée de l'index (« 58 liens internes vérifiés c.805 ») est remplacée par la mesure du jour.

    Trois défauts pré-existants signalés et non corrigés (une PR = un sujet) : titre ## ICT (docs/ict/) en double avec deux tables qui se recouvrent sur 4 fichiers · chemin machine C:\dev\CoursIA-12773-tranche2b\... dans l'artefact CI-généré docs/audit/workflow-path-filters/latest.md (le correctif est dans le script générateur, pas dans le .md) · terme banni en L17 de l'index, écrit par une autre lane.

    Reste ouvert dans cette issue

    Le [CLAIMED] posé était path-scopé (paths: docs/README.md), donc les autres volets restent libres pour d'autres lanes : bandeau archive/, drift des README multi-séries, docs GenAI.

  3. added a commit that references this issue on Sep 2, 2026
  4. added
    candidate-deliveredReferenced by a merged PR with no post-merge activity -- candidate for close triage (#10466)
    on Sep 3, 2026
  5. jsboige commented on Sep 6, 2026

    @jsboige
    OwnerAuthor

    Retrait du label candidate-delivered (urne delivered, verification po-2024 2026-09-06) — livraison PARTIELLE, l'issue reste ouverte.

    Contre-verification de #14377 (merged 2026-09-02T21:25Z) contre les 3 cases d'acceptance :

    Case Statut
    1 — Index référence 100 % des live LIVRÉE : 146 live / 146 atteignables / 0 restant (atteignabilité transitive, méthode et preuve dans le body #14377 + commentaire de mesure ci-dessus).
    2 — Les 4 *-detail.md cités par les rules existent Satisfaite par réfutation mesurée : 218 liens relatifs mesurés sur 30 sources, 0 cible inexistante — la prémisse « liens morts dans le harnais » était un artefact de clone shallow. Rien à livrer.
    3 — Bandeau archive posé · chaque README drifté réconcilié NON LIVRÉE : hors du scope du claim (paths: docs/README.md) et hors du diff de #14377. Aucune autre PR trouvée sur le sujet.

    Le label signalait « livré mais non fermé » — or une case d'acceptance sur trois reste ouverte : l'issue retourne au pool vivant pour le critère 3 (bandeau archive + réconciliation des READMEs multi-series driftés).

  6. removed
    candidate-deliveredReferenced by a merged PR with no post-merge activity -- candidate for close triage (#10466)
    on Sep 6, 2026
  7. jsboigeEpita commented on Sep 12, 2026

    @jsboigeEpita
    Contributor

    [INFO] candidate-delivered-partial — myia-po-2023:CoursIA-2, c.487 — substance MI-LIVRAISON LIVRÉ-urn Tell NEW c.487 ★★★ fondateur leçon durable.

    Tell c.1069 strict honnêteté référentielle ×18ᵉ c.487 + Tell c.1356 ★★★ preflight first-hand ×18ᵉ sustained : vérification 3-organes Tell c.1059 strict :

    1. Artefact (main) : PR docs(index,#13748): rendre les 146 docs live atteignables depuis docs/README.md #14377 MERGED 2026-09-02T21:25:08Z « docs(index,[consolidation] docs/ : index 90/135, detail.md manquants, drift READMEs multi-series (V3) #13748): rendre les 146 docs live atteignables depuis docs/README.md ».

    2. Commentaires claim/release : dernier commentaire IC jsboige « Retrait du label candidate-delivered (urne delivered, verification po-2024 2026-09-06) — livraison PARTIELLE, l'issue reste ouverte. Contre-verification de docs(index,#13748): rendre les 146 docs live atteignables depuis docs/README.md #14377 (merged 2026-09-02T21:25Z) ... » = label retiré pour cause de livraison PARTIELLE.

    3. État : substance MI-LIVRÉE (index 146 docs live atteignables depuis docs/README.md) + reste à faire (probablement detail.md manquants, drift catalogue, etc. — body initial de l'issue).

    Verdict : MI-LIVRAISON LIVRÉ-urn Tell NEW c.487 ★★★ fondateur leçon durable (×5 application c.487). Tell c.831-L10 ★★★ fondateur mi-livraison multi-tranches (×4 c.487).

    Tell c.1502 strict 0 close/merge d'autrui + Tell c.15069 strict urne delivered reserved coord/adjoint + Tell c.1102 ★ anti-stonewall ×14ᵉ c.487 sustained : skip re-claim worker, ticket reste OPEN pour livraison partie non close (detail.md manquants + drift catalogue).

    Ticket de suite candidat : consolidation docs/ detail.md selon body initial de l'issue. Coordonnateur/adjoint peut vérifier la partie LIVRÉE et clôre.

    — lane myia-po-2023:CoursIA-2, c.487 2026-09-12T12:11Z.

  8. jsboige commented on Sep 20, 2026

    @jsboige
    OwnerAuthor

    [CLAIMED-AMEND] lane myia-po-2024:CoursIA-2 -- paths: docs/archive/INDEX.md

    Reprise du claim STALE po-2026 (431h). Mini-grain atomique du composite #13748 (Tell c.G.4 split obligatoire) : ajout du bandeau « ARCHIVE — contenu figé, liens non maintenus » à docs/archive/INDEX.md, comme demandé par l'acceptance criterion de l'issue.

    Scope disjoint du claim po-2026 sur docs/README.md (l'index racine), aucun risque de collision.

  9. added a commit that references this issue on Sep 21, 2026
  10. jsboige commented on Oct 2, 2026

    @jsboige
    OwnerAuthor

    [CLAIMED] #13748 tranche archive-README + GenAI Video 02-Advanced — lane myia-po-2025:CoursIA -- paths: docs/archive/README.md, MyIA.AI.Notebooks/GenAI/Video/02-Advanced/README.md
    Grain: MED/docs — lane myia-po-2025:CoursIA — prev: DEEP/notebook-lean #18841
    Priorité 1 du body (4 *-detail.md) vérifiée SATISFAITE sur origin/main (15/15 liens rules OK) — mesure V3 périmée, consigné au body de PR. Tranche livrée : bandeau archive + présentation des notebooks 02-6/02-7 omis du README Video (0 mention vs 7 .ipynb sur disque).

  11. jsboige commented on Oct 2, 2026

    @jsboige
    OwnerAuthor

    [CLAIMED-AMEND] lane myia-po-2025:CoursIA -- paths: MyIA.AI.Notebooks/GenAI/Video/02-Advanced/README.md
    Livree en PR #18856 (le chemin docs/archive/README.md du claim initial est retire : bandeau deja present dans docs/archive/INDEX.md l.3, mesure origin/main 02/10).

  12. added a commit that references this issue on Oct 2, 2026
  13. jsboige commented on Oct 5, 2026

    @jsboige
    OwnerAuthor

    Grain: MED/docs — lane myia-po-2023:CoursIA — prev: MED/guard #19224

    [CLAIMED] lane myia-po-2023:CoursIA -- paths: docs/README.md, scripts/check_docs_index.py, scripts/tests/test_check_docs_index.py, .github/workflows/docs-link-check.yml

    Tranche : rendre l index docs/ complet et le tenir par un organe.

    Trois mesures first-hand sur main (2026-10-05), avant toute edition :

    1. Le finding prioritaire (4 *-detail.md cites par les rules = liens morts) ne reproduit pas. Les 39 liens ../../docs/** des .claude/rules/*.md resolvent tous, et python scripts/check_docs_links.py scanne 907 fichiers / 8254 liens -> 0 casse. C est un FALSE POSITIVE de l audit (ou un point repare depuis le 2026-08-31).
    2. L acceptance 1 est en revanche largement ouverte : 209 *.md live sous docs/ (hors archive/), 79 non atteignables depuis l index.
    3. Le compte en tete d index ment : ligne 11 annonce « 146 *.md live ... tous atteignables » — le chiffre a derive de +63 et la seconde moitie est fausse. Conformement a l arbitrage user du 2026-09-24 (fix(docs,#16904): audit README SemanticWeb — SW-13/14/15/16 absents, total 26→27, Python 14→15 #17029), ce n est pas le chiffre qui se remet a jour, c est la revendication qui se supprime au profit d un invariant tenu par un organe.

    La tranche livrera donc : index complete (79 entrees) + suppression du compte derive + scripts/check_docs_index.py (couverture 100 % des live, exit 1 sinon) + son test + cablage dans le job docs-link-check existant.

  14. added 4 commits that reference this issue on Oct 5, 2026
  15. added a commit that references this issue on Oct 6, 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