Re:Code May Work, But It Still Might Suck
by tempestn on Saturday March 30, 2013 @01:47AM
(#5464572)
Reminds me of my grade 10 computer science teacher. This was in 1996, coding in qbasic iirc. Anyway, he was biiiiig on comments. Consistently the only marks lost on my submissions were for insufficient comments. But these grade 10 assignments were pretty simplistic. I mean, if the assignment is to print the numbers 1 to 10 on the screen, wtf are you supposed to comment? I eventually got a perfect score by inline commenting every fucking line of the program.
Glad to see the article make the distinction between well written, well commented code, and over-commented code. Not once through high school or university was I taught the basic concept of 'comment the why'; the what should be self-explanatory.
Glad to see the article make the distinction between well written, well commented code, and over-commented code. Not once through high school or university was I taught the basic concept of 'comment the why'; the what should be self-explanatory.