L’originale su: http://blogs.microsoft.co.il/blogs/shair/archive/2009/05/03/what-is-the-best-comment-in-source-code-you-have-ever-encountered.aspx 1. /// <summary>     /// Class used to work around Richard being a fucking idiot    ...

Leggendo Refactoring to Patterns sono venuto a conoscenza dell'iniziativa che ha avuto l'autore, ormai anni fa (nel 1995), nel creare dei Gruppi di Studio dove vengono analizzati/discussi/utilizzati i vari patterns, tutto orientato al refactoring e al miglioramento del design di un applicativo. Non sarebbe un'iniziativa carina a cui pensare? Tags: Refactoring | Agile

Mi è capitato spesso di legger commenti del tutto inutili al codice: // Calcola il valore inserito per due int res = CalcolaIlValoreInseritoPerDue(valoreDaCalcolare); Inseriti perchè un PM troppo invasivo o una mente troppo contorta, hanno obbligato lo sviluppatore a scrivere. Una delle regole del Refactoring consiste nello scrivere codice autoesplicativo; così facendo inserire dei commenti nel codice diventa ridondante e inutile. Rimane però un caso nel quale scrivere un commento può tornare utile, secondo me. Capita che sul finire di un progetto, non siamo stati abbastanza lungimiranti da scrivere una procedura in maniera abbastanza generica da poter applicare in più casi; così, con la morte nel cuore,...