Nettes Thema, doch sollte Code gar nicht kommentiert werden !!
Warum das?
1.) Code sollte selbsterklärend sein. Das schließt Methoden, Klassen etc. ein.
2.) Ein Entwickler sollte bestrebt sein, seinen Code zu verbessern. Soll heißen, dass man Code klar und für jedermann verständlich schreiben sollte. Dazu gehört, dass man sich z.B. an die 5 Prinzipen (S.O.L.I.D) halten sollte. Dies wäre schon der erste Schritt zu einfachen Code.
Kommentare dienen als Vorwand, seinen Code nicht verbessern zu müssen, da dies ja über den Kommentar geregelt wurde.
EDIT: Wenn es wirklich nicht anders geht, dann ist ein Kommentar sinnvoll, solange es kein Roman ist.
Eine Softwaredokumentation ist aber im Gegensatz sinnvoll :-)