Idea principale

Intorno a un cantiere si formano spontaneamente tre documenti: il modello di scheda da compilare, il documento di metodo, le istruzioni date all'agente che esegue. Una stessa regola — «uno scostamento non modifica mai il corpo della scheda» — finisce scritta in tutti e tre, ogni volta con parole un po' diverse, e ogni copia è nata dal desiderio di fare bene.

Finché non cambia niente, nessuno ne soffre: i tre dicono la stessa cosa. Il giorno in cui la regola evolve se ne corregge uno, ci si dimentica degli altri due, e tre documenti si contraddicono senza che nessuno sappia quale fa fede. La duplicazione non costa niente quando si scrive e costa tutto alla prima modifica.

Un'IA ci resiste peggio di un umano: legge tutti e tre senza vedere che divergono, e fonda la sua analisi su quello che ha aperto per primo. Da qui la disciplina opposta — ogni regola vive in un posto solo; il modello di scheda descrive unicamente la forma, quali campi e quali valori ammessi, e rimanda al metodo per tutto il resto.

Perché è importante

Dà un criterio di scrittura applicabile nel momento in cui si è tentati di ricopiare: la domanda non è «è utile qui?» — lo è quasi sempre — ma «dove vivrà questa regola quando cambierà?».

L'ironia si ritorce spesso contro questo genere di cantiere: si costruisce un repertorio destinato a eliminare le definizioni duplicate duplicando le sue stesse regole.

Sfumature e limiti

Una duplicazione assunta e dichiarata è un altro caso: in una scheda di oggetto, i collegamenti sono scritti due volte — una nell'intestazione per gli strumenti, una nel corpo per la vista a rete — e questa eccezione è scritta come tale.

E il rimando ha un costo di lettura: un lettore che deve aprire tre documenti per ricostruire una regola finisce per ricopiarla lui stesso nei suoi appunti.

Domande aperte

• Dove collocare una regola che riguarda insieme la forma di un artefatto e il metodo che lo produce, senza spezzarla in due metà incomprensibili?