2 ms·
IME it's the "completely brilliant" code that your future self will hate you for, and needs the most comments. Moreover, when the weight of those comments tren
by bgribble 9y ago
IME it's the "completely brilliant" code that your future self will hate you for, and needs the most comments.
Moreover, when the weight of those comments trends towards 50% being justifications for why you did it that way, it's an excellent sign that your code has gone from "brilliant" to "super-genius", as in "Wile E. Coyote, Super-Genius".
"Completely dumb" code can be read by your future self without comments. Even, sometimes, by other people!
- krylon 9y agoSometimes, I have seen (and, on at least one occasion, written) code that was brilliant in its simplicity. Very clever, but at the same time completely obvious. (In the sense that one needed to be clever to come up with it, but it was easy to understand if somebody showed it to you.) But for the general case, I do wholeheartedly agree with you.