Tesi

Fare del codice la fonte di verità di un prodotto lascia fuori il suo significato

Info

Scritto originalmente in francese. Tradotto dall'IA — il significato è stato preservato, non la prosa.

Angolo

Il codice di un prodotto stabilisce come funziona, ma non ne porta il significato: la regola che si può enunciare solo dopo aver letto cinque file, i casi particolari di un oggetto, le parole che usano i clienti, la portata di una nozione che cambia da un'applicazione all'altra non vi si leggono, e si distribuiscono fra il cuore del codice, la base di dati, le schermate e le traduzioni. Eppure questo significato esiste, nella testa di poche persone, e si trasmetteva benissimo finché si poteva bussare alla porta del collega giusto. Due cose lo rendono oggi insostenibile: ogni reparto ricostruisce quel modello per conto proprio — documentazione, gare d'appalto, formazione, supporto — con una spesa che non compare in nessun budget; e un agente non bussa a nessuna porta: ciò che non è stato scritto lo riempie in modo plausibile, coerente e a volte falso. Mettere per iscritto il modello del prodotto — i suoi oggetti, i loro collegamenti chiamati con verbi, le loro regole, le loro parole — non sostituisce quindi il codice: è l'unico modo per rendere utilizzabile ciò di cui il codice fa fede.

Sintesi

Lo spostamento che ha fatto del codice il riferimento era giusto: ha eliminato il lavoro di tenere aggiornati documenti che descrivevano qualcosa di diverso dalla realtà. Queste note dicono cosa ha lasciato da parte, e perché il conto arriva adesso.

Si richiamano a vicenda su tre piani. Sulla natura di ciò che manca, anzitutto: né un racconto né una definizione isolata, ma una struttura — oggetti collegati da verbi precisi, regole enunciate in una frase, un lessico a più livelli. Sulla dispersione, poi: questo significato non è assente, è sparpagliato, e ciascuno dei quattro posti in cui si deposita dice ciò che gli altri tacciono — con, in più, le contraddizioni interne che si vedono solo mettendoli a confronto. Sull'economia, infine: la ricostruzione continua non costava niente di visibile finché era umana, e il passaggio a destinatari che non possono chiedere ne fa emergere il prezzo.

Il beneficio non si limita alla documentazione. Una regola scritta nel linguaggio del business è un test così com'è; la segnalazione di un cliente si qualifica meccanicamente a seconda che contraddica una regola scritta o riveli una regola mai posta; una nozione senza un posto in cui sia definita smette di produrre tre saldi diversi su tre schermate. Sono usi distinti di uno stesso artefatto, ed è questo a distinguere questo lavoro da una documentazione in più.

Tensioni / contraddizioni

Niente di tutto questo è misurato. Il meccanismo è chiaro — si elimina la parte indovinata — ma la fase di utilizzo non è cominciata, e nessun confronto fra richieste trattate con e senza il repertorio è stato fatto. Le note che riguardano gli usi descrivono quindi un'aspettativa, là dove quelle che riguardano il costo descrivono una constatazione.

Seconda tensione, con la dottrina del codice come fonte di verità: il repertorio reintroduce un artefatto scritto a mano, quindi esposto al rischio di divergere dal prodotto — esattamente ciò che lo spostamento verso il codice aveva eliminato. La risposta adottata qui è un confine interno, il corpo rigenerabile e gli scostamenti mantenuti; resta da mettere alla prova sulla durata.

Domande

  • Quale parte del modello mentale di un prodotto non ha alcuna possibilità di essere scritta, perché si formula solo nel momento in cui una domanda precisa la reclama?
  • Che ne è dell'artefatto quando due applicazioni di una stessa suite danno un significato diverso alla stessa parola: una scheda per portata, o una scheda che le porta entrambe?
  • A quali condizioni le funzioni che non leggono il codice — supporto, prevendita, formazione — contribuiscono a questo repertorio invece di limitarsi a consultarlo?