Copy page

Audit de la documentation

Informations obsolètes et héritées

En bref : L'abandon du plan de POC et l'observation de l'instance CRISalid sont propagés dans les pages publiées, et chaque lien interne, ancre comprise, mène à une page qui existe. Le registre des chiffres clés empêche le retour des formulations retirées. Le point le plus grave est hors des pages : deux anciens index de recherche, versionnés dans public/pagefind/ et docs/public/pagefind/, contiennent des formulations que le registre interdit pour les failles de LPI. Le premier est copié dans chaque construction du site. Restent des dates d'état sur l'accueil et dans les pages LPI, trois libellés de liens qui nomment des pages disparues, deux autres imprécis, des faits à échéance qui se périment tout au long de novembre, et des fichiers de pilotage (CONTEXT.md surtout) qui décrivent encore d'anciennes pages et quatre décisions au lieu de cinq.

Chronologie

Les dates ci-dessous sont des faits. Les lignes à partir de la semaine du 2 novembre sont des échéances : chaque phrase du site qui les annonce au futur se périme dès que la date est passée.

Les faits datés du dossier et les échéances à venir

Chargement du schéma pédagogique...

Priorité 1 : un ancien index de recherche publié avec le site

La recherche du site n'utilise pas ces fichiers, mais ils restent publics par leur adresse et dans l'historique Git. Il faut retirer public/pagefind/ et docs/public/pagefind/ du dépôt, puis vérifier que la construction suivante ne publie plus que l'index qu'elle régénère.

Priorité 2 : dates d'état dans les pages publiées

Pour les failles, la grille des questions emploie une date de vérification : « Revérifiées le 30 octobre 2026 : toujours ouvertes sur le code le plus récent » (grille-evaluation.mdx:16). Les autres pages tournent la même date en date d'état. Ces phrases se lisent comme un état présent et vieillissent sans que le texte change.

Aucune règle du registre ne détecte ces formules : scripts/chiffres-cles.json ne cite le mois d'octobre que dans ses valeurs (l.26, 45, 96), jamais dans ses motifs interdits. Un motif au 3[0-1] octobre|au 29 octobre empêcherait leur retour dans les pages publiées.

Priorité 3 : libellés de liens périmés ou imprécis

Les liens fonctionnent. Trois libellés annoncent une page qui n'existe plus (plateformes nationales, volumétrie, besoin initial). Deux autres sont seulement imprécis : la page visée existe, mais le libellé ne la nomme pas exactement (glossaire, accueil).

Le schéma d'architecture recommandée (l.69) écrit encore « Frontend public statique ou ISR ». Le deck D3 demande de dire « vitrine synchronisée », pas « site statique » (03-architecture-crisalid/deck.md:592).

Faits à échéance

Ces phrases sont justes tant que la date n'est pas passée, mais elles en parlent au futur. Il faudra les reprendre dès que la date sera passée ou le prérequis levé.

Après le webinaire, le statut « Déclaré » des fonctions de correction et de fusion de SoVisu+ doit être revu, ainsi que le prérequis correspondant de la Partie 2.

Decks : des dates d'état revendiquées, et aucun garde-fou

Les decks se donnent pour convention de dater les faits qui dépendent d'une vérification (D2 deck.md:25, D8 deck.md:25). Plusieurs passages emploient pourtant ces dates comme des dates d'état :

• D6 : deck.md:21 et :564 (prérequis non levés) ;
• D8 : deck.md:25 (prérequis) et :423 (responsable métier « pas encore nommé ») ;
• D2 : deck.md:253 et :378 (failles « toujours ouvertes au… »), :295 (note provisoire) ;
• D3 : deck.md:557 (failles) et :797 (« aucune n'est levée aujourd'hui ») ;
• D7 : deck.md:196 (failles « restaient ouvertes » au 30 octobre).

Garder ou retirer ces dates relève de l'auteur. En revanche, docs/05-deck/ est exempté du registre (chiffres-cles.json, clé exemptions) : seules les deux règles de sécurité marquées partout s'y appliquent, et rien n'empêche une autre formulation retirée d'y revenir. Une application manuelle de tous les motifs du registre aux cinq sources deck.md et au catalogue ne trouve aucun motif interdit.

Fichiers de pilotage, hors site

Ces fichiers ne sont pas publiés, mais ils servent de point de reprise. Ils décrivent encore des pages supprimées et des décisions remplacées.

Les volumes de CONTEXT.md (pages, mots) restent saisis à la main : aucun script ne les produit.

Quatre dossiers vides subsistent dans docs/05-deck/ (01-direction-restitution-audit, 04-securite-rgpd, 05-valeur-impact, 06-lancement-maquette). Git ne les suit pas et le site ne les publie pas, mais le dernier porte un vocabulaire retiré (« maquette », chiffres-cles.json, entrée « Vocabulaire de la décision »). Les supprimer en local suffit.

Ce qui tient

Ces points ne sont plus des constats, mais le relecteur doit les connaître.

• Instance et abandon du POC : le registre interdit les anciennes formulations sur l'instance (chiffres-cles.json, entrée « État de l'instance CRISalid de Paris-Saclay ») et node scripts/check-dossier.mjs passe sans écart.
• Plan du POC abandonné : archivé dans archives/, hors des fichiers publiés (recit.config.ts:60), avec une redirection de l'ancienne adresse vers la feuille de route (generate-navigation.mjs:723).
• Liens internes : dans les pages et dans les sources des decks, chaque lien interne pointe vers une page existante, et chaque ancre vers un titre existant. Aucun ne passe par une redirection.
• Date des pages : chaque page affiche sa date de dernière modification, tirée de Git (recit.config.ts:63).

Recommandations

1. Retirer public/pagefind/ et docs/public/pagefind/ du dépôt, puis contrôler les fragments servis par la construction suivante. Étendre le contrôle des motifs interdits aux fichiers publiés, pas seulement aux sources.
2. Remplacer les dates d'état des pages publiées (priorité 2), en commençant par l'accueil. Ajouter au registre un motif qui les détecte.
3. Corriger les trois libellés qui nomment des pages disparues et préciser les deux autres (priorité 3) et le libellé « statique » du schéma d'architecture.
4. Reprendre les faits à échéance au fil des dates : fin de la semaine du 2 novembre, 9, 12 et 17 novembre.
5. Remettre à jour les fichiers de pilotage, en commençant par les décisions et la description des sections dans CONTEXT.md, puis supprimer context-audit.md ou écrire le script qui le génère, avec les volumes de CONTEXT.md.