Non dovrebbe essere necessario trattare il metodo in modo diverso da qualsiasi altro. In questo esempio, un metodo denominato CompareTo()
sarebbe ovvio per chiunque abbia un'esperienza .NET significativa come implementazione di IComparable<T>
. L'idiota che lo commenta o lo elimina verrà informato dal compilatore che la classe non implementa più IComparable<T>.CompareTo()
, e a quel punto dovrebbe capire che hanno incasinato e rimesso a posto. Il bozo totale che, ricevendo questo errore, pensa che la soluzione migliore sia rimuovere l'interfaccia IComparable<T>
dalla definizione della classe (senza un inferno di una buona ragione, come se fosse tracciato ogni utilizzo della classe attraverso la tua base di codice ed è 100% positivo la classe non fa mai parte di alcuna operazione di ordinamento) probabilmente non ha bisogno di lavorare per la tua azienda.
Se vuoi essere gentile, //Implementation of IComparable<T>
posizionato da qualche parte vicino alla dichiarazione della funzione (appena sopra di esso, o appena dentro il corpo della funzione) dovrebbe renderlo abbastanza chiaro anche per le teste di ossa menzionate sopra.
Se vuoi essere davvero gentile, puoi xml-doc la classe / metodo, e nel tag <remarks>
, affermare che questo metodo è l'implementazione di IComparable<T>
per la classe. Questo non verrà visualizzato solo in origine, ma anche in qualsiasi documentazione SandCastle creata. Potrebbe apparire in IntelliSense, ma ne dubito; le osservazioni possono essere piuttosto grandi. Se è assolutamente positivo conoscere tramite IntelliSense che il metodo è l'implementazione dell'interazione, menzionarlo nel tag <description>
.