Nel lavoro tecnico considero la gentilezza una forma di precisione: spiegare un problema in modo che l’altra persona possa capirlo, rispondere e intervenire. Una review può essere ferma senza diventare un giudizio su chi ha scritto il codice.
È un criterio che voglio applicare sia nel team Romiltec sia con i clienti. Non richiede di attenuare un errore o accettare una soluzione sbagliata. Richiede di separare fatti, interpretazioni e richiesta concreta.
Scrivere un commento che permetta di agire
Consideriamo un esempio ipotetico: una modifica fa fallire un test di integrazione. “Hai rotto i test” segnala il problema, ma lascia aperte causa e aspettativa. Un commento più utile indica quale caso fallisce e quale comportamento era previsto.
Scriverei, per esempio: “Nel caso senza metadati ora arriva null e il conteggio genera un errore. Il contratto prevede una lista vuota: possiamo mantenere quel risultato?”. Chi legge ha un caso da riprodurre e una decisione da discutere.
Non chiederei automaticamente di aggiornare il test perché la nuova implementazione sembra più pulita. Prima bisogna capire se è cambiato intenzionalmente il comportamento o se il test ha trovato una regressione.
Le indicazioni Google sui commenti di review invitano a spiegare il ragionamento e rendere riconoscibili suggerimenti e requisiti. È utile anche per evitare che una preferenza personale diventi un blocco implicito.
Il dissenso deve riguardare una scelta
Quando non condivido una soluzione, provo a indicare il vincolo che ritengo violato: costo operativo, compatibilità, accesso ai dati o difficoltà di manutenzione. In questo modo la discussione può cambiare con nuove informazioni.
Il sarcasmo rende più difficile trovare quel vincolo. “Scelta interessante” può significare approvazione o critica; il lettore deve interpretare il tono prima di occuparsi del codice. Preferisco una frase diretta, anche quando è scomoda.
Se il confronto scritto continua a ripetersi senza progressi, una breve conversazione può chiarire i presupposti. La decisione finale va poi riportata nel contesto del lavoro, perché serva anche a chi non era presente.
Rispondere al cliente con ciò che sappiamo
Durante un disservizio, il primo messaggio dovrebbe chiarire impatto osservato, attività in corso e momento del prossimo aggiornamento. Una spiegazione tecnica lunga può arrivare dopo, quando la causa è stata verificata.
Distinguerei “abbiamo individuato” da “stiamo verificando”. Se non conosco ancora la causa, dichiararla come ipotesi evita di dover difendere una spiegazione prematura. Riconoscere l’effetto sul lavoro del cliente non richiede di promettere che non accadrà mai più.
Al termine, collegherei il problema alle azioni: correzione applicata, verifica eseguita e intervento ancora aperto con una responsabilità. È una forma di chiarezza più utile di un messaggio rassicurante privo di dettagli verificabili.
Un errore ripetuto richiede domande migliori
Non passerei automaticamente da “errore di processo” a “problema di carattere” dopo un numero prefissato di episodi. Guarderei se istruzioni, strumenti, competenze e carico consentono davvero di svolgere il compito come richiesto.
Il postmortem senza colpevolizzazione aiuta a ricostruire condizioni e scelte. La responsabilità resta: una correzione deve avere un seguito e qualcuno che la porti a termine.
Se serve discutere il comportamento di una persona, sceglierei un confronto riservato, con esempi e aspettative esplicite. Usare la riunione di team per mettere qualcuno sotto esame aggiunge un pubblico senza necessariamente aggiungere informazioni.
Valutare la chiarezza nel lavoro quotidiano
Non attribuirei rinnovi dei clienti o permanenza delle persone a una singola email scritta bene. Guarderei segnali più vicini alla comunicazione: richieste comprese, decisioni ritrovabili, obiezioni espresse e attività che ripartono dopo un confronto.
Il mio controllo prima di inviare è semplice: ho descritto il fatto, spiegato perché conta e reso chiaro il passo successivo? Se manca uno di questi elementi, il destinatario dovrà completare il messaggio al posto mio.