Kurzdefinition

Artefakt, das als maßgeblich bestimmt ist, wenn sich mehrere Darstellungen desselben Gegenstands widersprechen, und aus dem die anderen neu aufgebaut oder korrigiert werden.

Ausführliche Definition

Der Ausdruck stammt aus den Informationssystemen, wo single source of truth den einzigen Ort bezeichnet, an dem ein Datum gespeichert ist, während alle anderen Orte nur abgeleitete Kopien halten. Die Bedeutung ist dort streng: Die Einzigkeit ist eine Eigenschaft der Architektur, die das System garantiert.

In den Texten dieses Blogs wird der Begriff für Artefakte statt für Daten verwendet, und die Einzigkeit ist dort eine organisatorische Wahl, keine technische Garantie. Nichts hindert eine Spezifikation daran, dem Repository zu widersprechen; das Repository zur Quelle der Wahrheit zu erklären sagt nur, was man mit dem Widerspruch tun wird — die Spezifikation korrigieren, nie umgekehrt.

Unter diesem Begriff werden oft zwei verschiedene Eigenschaften vermengt. Maßgeblich sein ist ein Rang: Man weiß, wer recht hat. Als Quelle dienen ist eine Fähigkeit: Man weiß, wie man die anderen Artefakte daraus gewinnt. Ein Objekt kann den Rang ohne die Fähigkeit haben — das war die Lage des Codes, solange er für diejenigen unlesbar blieb, die die Dokumente erstellten.

Gebrauch im Feld

Verwendet, um einen Konflikt zwischen zwei Artefakten zu entscheiden, ohne ihre Autoren zusammenzurufen, und um die Herstellungsrichtung einer Kette von Produktdokumenten zu prüfen.

Synonyme und Varianten

„Was maßgeblich ist“, „Referenz“, „single source of truth“ in seiner ursprünglichen Verwendung.

Nicht zu verwechseln mit

• Lieferobjekt — Deliverable — ein für einen Empfänger aufbereitetes Erzeugnis, bauartbedingt ausgerichtet. Eine Quelle der Wahrheit ist auf kein Publikum ausgerichtet; dasselbe Objekt kann jedoch beides sein, und das ist beim Code der Fall.
• Zwischenartefakt — Artefact intermédiaire — ein Dokument, das erstellt wird, um Information innerhalb der Organisation in Umlauf zu bringen, vergänglich und ohne externen Empfänger. Es leitet sich aus einer Quelle der Wahrheit ab, ist aber selbst keine.
• Feature Flag — Feature flag — ein Schalter, der im Code steht und außerhalb davon eingestellt wird, und dessen Zustand entscheidet, welches von mehreren Verhalten ausgeführt wird. Es konkurriert nicht mit der Quelle der Wahrheit: Es verhindert, dass sie allein entscheidet, was ein bestimmter Kunde beobachtet.
• Archiv — Aufbewahrung dessen, was war. Die Quelle der Wahrheit sagt den aktuellen Stand; das Archiv sagt einen vergangenen Stand und beansprucht nicht, für die Gegenwart maßgeblich zu sein.

Beispiele

„Der Code ist nicht mehr nur das finale Lieferobjekt: Er wird zum zentralen Element, zur Quelle der Wahrheit, um die herum die anderen Produktartefakte kreisen und neu aufgebaut werden.“

Mehrdeutigkeiten / Debatten

Das Wort „Wahrheit“ suggeriert eine Vollständigkeit, die es nicht gibt. Das Repository ist maßgeblich für das, was das Produkt tut, und sagt nichts darüber, was gewollt und was verworfen wurde. Eine Organisation kann also ohne Widerspruch mehrere Quellen der Wahrheit haben, wenn jede über eine andere Frage herrscht — was dem Begriff dann seine ursprüngliche Einzigkeit nimmt.