Definizione breve

Artefatto designato come quello che fa fede in caso di disaccordo tra più rappresentazioni di uno stesso oggetto, e a partire dal quale le altre vengono ricostruite o corrette.

Definizione dettagliata

L'espressione viene dai sistemi informativi, dove single source of truth designa il luogo unico in cui un dato è memorizzato, mentre gli altri luoghi ne conservano solo copie derivate. Lì il senso è rigoroso: l'unicità è una proprietà dell'architettura, garantita dal sistema.

Negli articoli di questo blog, il termine è usato per artefatti e non per dati, e l'unicità è una scelta organizzativa, non una garanzia tecnica. Niente impedisce a una specifica di contraddire il repository; designare il repository come fonte di verità dice soltanto che cosa si farà della contraddizione: correggere la specifica, mai il contrario.

Sotto questo termine si confondono spesso due proprietà distinte. Fare fede è un rango: si sa chi ha ragione. Servire da fonte è una capacità: si sa estrarne gli altri artefatti. Un oggetto può avere il rango senza la capacità — era la situazione del codice finché restava illeggibile per chi produceva i documenti.

Uso nel dominio

Si usa per risolvere un conflitto tra due artefatti senza riunirne gli autori, e per stabilire il senso di fabbricazione di una catena di documenti di prodotto.

Sinonimi e varianti

«Ciò che fa fede», «riferimento», «single source of truth» nel suo uso originario.

Da non confondere con

• Deliverable — Deliverable — produzione messa in forma per un destinatario, orientata per costruzione. Una fonte di verità non è orientata verso un pubblico; uno stesso oggetto può tuttavia essere entrambe le cose, ed è il caso del codice.
• Artefatto intermedio — Artefact intermédiaire — documento prodotto per far circolare l'informazione all'interno dell'organizzazione, deperibile e senza destinatario esterno. Deriva da una fonte di verità, non lo è.
• Feature flag — Feature flag — interruttore inserito nel codice e regolato fuori da esso, il cui stato decide quale di più comportamenti viene eseguito. Non entra in concorrenza con la fonte di verità: è ciò che le impedisce di stabilire da sola che cosa osserva un determinato cliente.
• Archivio — conservazione di ciò che è stato. La fonte di verità dice lo stato attuale; l'archivio dice uno stato passato e non pretende di fare fede sul presente.

Esempi

«Il codice non è più solo l'artefatto finale: diventa l'elemento centrale, la fonte di verità attorno alla quale gravitano e si ricostruiscono gli altri artefatti di prodotto.»

Ambiguità / dibattiti

La parola «verità» fa credere a una completezza che non esiste. Il repository fa fede su ciò che il prodotto fa e non dice nulla di ciò che è stato voluto né di ciò che è stato scartato. Un'organizzazione può quindi avere più fonti di verità senza contraddizione, se ciascuna governa una domanda diversa — il che priva però il termine della sua unicità originaria.