What was observed
La documentation devient vite obsolète lorsqu'elle est séparée des entités, relations et routes que le système logiciel utilise réellement.
RESEARCH QUESTION
Cette question étudie si un logiciel peut expliquer son objectif, ses preuves, dépendances et limites à travers le même graphe qui génère ses pages publiques et ses fiches machine-readable.
EDITORIAL FRAME
A concise view of its scope, position, limitations and supporting sources.
La documentation devient vite obsolète lorsqu'elle est séparée des entités, relations et routes que le système logiciel utilise réellement.
Un projet peut avoir pages, JSON-LD, données de recherche, exports de relations et fichiers source qui divergent si aucun graphe structuré ne joue le rôle de couche d'autorité.
Le graphe de connaissance peut devenir la couche documentaire principale lorsque pages, identifiants, voisinages de graphe, documents de recherche et panneaux relationnels sont générés depuis les mêmes fiches source.
L'explicabilité progresse lorsque l'interface publique expose le graphe au lieu de le cacher. Une page devrait montrer ce qu'elle est, ses liens, ses preuves et les limites de ses affirmations.
Le site démontre déjà une réponse partielle. HTML public, identifiants, JSON-LD, recherche et fichiers de graphe local sont générés depuis des fiches typées plutôt que maintenus séparément.
La documentation dérive lorsqu’elle reste hors du système qu’elle décrit. Une page statique peut être exacte le jour de sa rédaction et trompeuse après quelques changements structurels.
Electronic Artefacts a besoin de fiches logicielles publiques utiles aux personnes, aux moteurs de recherche et aux futurs agents. Cela exige des identifiants stables, des relations typées, des pages lisibles et des exports machine-readable générés depuis une même source.
Un graphe de connaissance peut devenir la couche documentaire. Si le graphe enregistre entités, relations, sources et versions, le site peut générer des explications plutôt que les dupliquer manuellement.
Le graphe ne supprime pas la responsabilité éditoriale. Il la rend visible. Une relation exige encore du jugement, mais une fois acceptée elle met à jour pages, recherche, JSON-LD et voisinages de graphe ensemble.
Le prochain problème concerne la profondeur de l’interface. Le graphe doit être assez visible pour aider la compréhension sans transformer chaque page en console d’administration.
RELATIONS DOCUMENTÉES
Chaque lien précise la nature de la relation entre deux entrées.
Comment un logiciel peut-il devenir explicable par son propre graphe de connaissance ?. 1.0.0. Electronic Artefacts, 2026-07-09. https://electronicartefacts.com/fr/research/questions/self-explaining-knowledge-graph-software/
22 liens publics relient cette page à des projets, concepts et références proches.