È, come detto nel commento citato ... ostile.
Scostante con te stesso
Immagina il seguente scenario. Stai visualizzando i log nel controllo del codice sorgente. Ti stai chiedendo cosa sia cambiato un commit. Invece di spiegarlo in un inglese semplice, ti dice:
Risolto # 1307
Gestisci il sistema di tracciamento dei bug, sperando di avere qualcosa di utile. Il bug n. 1307 è stato risolto. Nella descrizione, vedi:
Stesso bug del n. 1284
Grazie, è molto utile. Devi ora passare alla segnalazione bug # 1284 per leggere che è un duplicato del bug # 1113 che si riferisce ai bug # 1112, # 1065 e # 1067.
Cinque minuti dopo, non hai idea di cosa cerchi all'inizio.
Un messaggio di registro di controllo versione molto più utile sarebbe:
Risolto il problema per cui gli utenti non potevano accedere con una password più lunga di 25 caratteri (vedi # 1307), rimuovendo l'applicazione dello stesso criterio di lunghezza della password al livello di accesso ai dati di quello utilizzato nel sito Web stesso.
Allo stesso modo, nel sistema di tracciamento dei bug, il rapporto n. 1307 potrebbe essere più autoesplicativo , ricordando di cosa trattava il rapporto sui bug n. 1284 e in che modo quello nuovo è diverso da quello vecchio.
Inospitale con i clienti
Questo non è l'unico problema di amicizia.
Un secondo è che facendo riferimento a troppo senza informazioni aggiuntive, si rendono inutilizzabili le note sulle patch / i registri di controllo della versione / i rapporti sul sistema di tracciamento dei bug per qualcuno che non ha molta familiarità con tali sistemi . Quando ti occupi quotidianamente di un sistema di tracciamento dei bug, sai come navigare rapidamente tra i rapporti, visualizzare più rapporti fianco a fianco, ecc. Quando sei un cliente senza background tecnico, puoi facilmente perderti.
Anche in questo caso, messaggi più dettagliati sono molto utili di un semplice riferimento. Nota che vuoi comunque conservare i riferimenti: niente è più sbagliato di un bug che è lo stesso di un bug che hai riscontrato due settimane fa, ma non ricordare il suo ID.
Come nota, lo stesso problema esiste in molte giurisdizioni. In Francia, ad esempio, non è insolito che una legislazione faccia riferimento a più fonti, che potrebbero cambiare nel frattempo. Ciò significa che per comprenderlo completamente, a volte devi trascorrere ore in una biblioteca, alla ricerca di dozzine di testi citati, ognuno dei quali ha i suoi riferimenti ad altri.