Ciao, e benvenuto nella quarta puntata della cinquantesima stagione. Oggi parliamo di un'abilità sottovalutata, che sta proprio al centro del lavoro di squadra, e che quasi nessuno insegna a chi programma. Chi fa questo mestiere è addestrato a parlare con le macchine; molto più raro, e molto più difficile, è saper spiegare cose tecniche complesse ad altri esseri umani. Oggi capiamo come scriverlo: comunicare le cose tecniche.
Partiamo dal perché conta così tanto, perché non è ovvio. Perché scrivere le cose tecniche è così importante? Perché una conversazione allinea le due persone nella stanza, adesso. Ma una spiegazione scritta allinea chiunque la legga: anche chi non è ancora nel team, anche te stesso tra un anno, quando ti sarai dimenticato tutto. Il documento sopravvive alla conversazione, e fa arrivare la comprensione a persone lontane nello spazio e nel tempo. Parlare risolve l'oggi; scrivere risolve anche il domani, e per molti più di due.
Voglio darti la prima idea profonda, perché ti sorprende. La prima idea è questa: scrivere è pensare. Essere costretti a spiegare qualcosa in modo chiaro rivela se l'hai davvero capito. Quando provi a metterlo sulla pagina e non viene, quasi sempre non è la pagina a essere confusa: è il tuo pensiero, reso visibile. Il pasticcio sul foglio è il pasticcio nella tua testa, portato alla luce. E sistemare la scrittura, cercare le parole giuste, sistema il pensiero. Non scrivi ciò che hai capito: capisci scrivendo. Ed è per questo che chi dice non so scrivere, ho solo le idee confuse ha spesso il problema al contrario: le idee sono confuse perché non le ha ancora scritte, e la scrittura è proprio lo strumento che le metterebbe a fuoco.
Voglio darti la seconda idea profonda, perché è cruciale per un team. La seconda idea: il codice dice il come, ma solo un essere umano può registrare il perché. Il codice ti mostra cosa è stato fatto. Non ti dirà mai perché proprio così e non in un altro modo, cosa era stato provato e scartato, quale vincolo ha costretto a quella scelta brutta ma necessaria. Quel ragionamento vive solo nella testa di chi c'era, e sparisce quando quella persona se ne va, a meno che qualcuno non lo scriva. Una decisione non documentata è una mina lasciata al futuro: qualcuno, un giorno, ci camminerà sopra chiedendosi perché mai sia stato fatto così.
Voglio essere onesto sul suo costo, perché è la ragione per cui si salta. Va detto: scrivere bene è lavoro vero. Costa tempo, spesso non è premiato, e sotto scadenza è la prima cosa che si taglia: tanto il codice funziona, la spiegazione la scrivo poi. Ma quel poi non arriva quasi mai, e saltare la scrittura è prendere in prestito dal futuro a un tasso d'interesse brutale. Risparmi un'ora oggi, e la fai pagare, moltiplicata, a chi dopo di te dovrà ricostruire da zero un ragionamento che era già chiaro nella tua testa, e che è andato perduto.
Voglio darti l'immagine che rende chiara questa idea, perché è netta. Pensa alla differenza tra dare indicazioni stradali a voce, e disegnare una mappa. Le indicazioni a voce svaniscono nel momento in cui vi separate: valgono per quella persona, in quell'istante. La mappa, invece, chiunque può seguirla, dopo, senza di te. La mappa costa più fatica a farsi, ma si ripaga infinite volte lungo tutta la sua vita, ogni volta che qualcuno la usa senza doverti disturbare. La conversazione è l'indicazione a voce; il documento è la mappa. E un team senza mappe è un team dove ogni nuovo arrivato deve chiedere la strada a voce, sottraendo tempo a chi la strada la conosce già, all'infinito.
Voglio trarre la lezione generale, perché va oltre il software. La lezione è che la capacità di rendere chiara un'idea complessa a un'altra mente, e in forma duratura, è una delle abilità a più alto rendimento che esistano. Perché è il modo in cui la comprensione viaggia tra le persone, e attraverso il tempo. E l'atto stesso di scriverla con chiarezza è il modo in cui scopri se l'avevi capita davvero. Non è un'abilità da contorno, buona per chi non sa programmare: è il moltiplicatore che fa arrivare lontano tutto il resto.
Per oggi ci fermiamo qui. Abbiamo visto l'abilità sottovalutata al centro del lavoro di squadra: comunicare per iscritto le cose tecniche. Conta perché una conversazione allinea due persone adesso, ma un documento allinea chiunque lo legga, anche te tra un anno: sopravvive alla conversazione. Due idee profonde. Scrivere è pensare: se non viene sulla pagina, è il pensiero a essere confuso, e sistemare le parole sistema il pensiero. E il codice dice il come, ma solo un umano registra il perché, quel ragionamento che sparisce con chi se ne va, se nessuno lo scrive. Il costo, onesto: scrivere bene è lavoro, e saltarlo è un prestito dal futuro a tasso brutale. Come una mappa, che costa di più ma si ripaga per sempre. La lezione: rendere chiara un'idea a un'altra mente, in forma duratura, è tra le abilità a più alto rendimento che ci siano. Nella prossima puntata: litigare bene, il disaccordo sano. Nelle note trovi qualche spunto. Se ti è utile, condividila. Grazie per l'ascolto, e ci sentiamo alla prossima.