Définition courte
Artefact désigné comme faisant foi en cas de désaccord entre plusieurs représentations d'un même objet, et depuis lequel les autres sont reconstruites ou corrigées.
Définition détaillée
L'expression vient des systèmes d'information, où single source of truth désigne l'emplacement unique où une donnée est stockée, les autres emplacements n'en détenant que des copies dérivées. Le sens y est strict : l'unicité est une propriété d'architecture, garantie par le système.
Dans les articles de ce blog, le terme est employé pour des artefacts et non pour des données, et l'unicité y est un choix d'organisation, pas une garantie technique. Rien n'empêche une spécification de contredire le dépôt ; désigner le dépôt comme source de vérité dit seulement ce qu'on fera de la contradiction — corriger la spécification, jamais l'inverse.
Deux propriétés distinctes se confondent souvent sous ce terme. Faire foi est un rang : on sait qui a raison. Servir de source est une capacité : on sait en extraire les autres artefacts. Un objet peut avoir le rang sans la capacité — c'était la situation du code tant qu'il restait illisible pour ceux qui produisaient les documents.
Usage dans le domaine
Employé pour trancher un conflit entre deux artefacts sans réunir leurs auteurs, et pour instruire le sens de fabrication d'une chaîne de documents produit.
Synonymes et variantes
« Ce qui fait foi », « référence », « single source of truth » dans son emploi d'origine.
À ne pas confondre avec
- Livrable — Livrable — production mise en forme pour un destinataire, orientée par construction. Une source de vérité n'est pas orientée vers un public ; un même objet peut cependant être les deux, ce qui est le cas du code.
- Artefact intermédiaire — Artefact intermédiaire — document produit pour faire circuler l'information à l'intérieur de l'organisation, périssable et sans destinataire externe. Il dérive d'une source de vérité, il n'en est pas une.
- Feature flag — Feature flag — interrupteur inscrit dans le code et réglé hors de lui, dont l'état décide lequel de plusieurs comportements s'exécute. Il n'entre pas en concurrence avec la source de vérité : il est ce qui l'empêche de trancher seule ce qu'un client donné observe.
- Archive — conservation de ce qui a été. La source de vérité dit l'état courant ; l'archive dit un état passé et ne prétend pas faire foi sur le présent.
Exemples
« Le code ne constitue plus seulement le livrable final : il devient l'élément central, la source de vérité à partir de laquelle gravitent et se reconstruisent les autres artefacts du produit. »
Ambiguïtés / débats
Le mot « vérité » fait croire à une exhaustivité qui n'existe pas. Le dépôt fait foi sur ce que le produit fait et ne dit rien de ce qui a été voulu ni de ce qui a été écarté. Une organisation peut donc avoir plusieurs sources de vérité sans contradiction, si chacune règne sur une question différente — ce qui prive alors le terme de son unicité d'origine.