Programming Forums - View Single Post

Jimbo · May 25th, 2006, 12:59 AM

I'd say overcommenting is actually not good. While you can definitely see what your code does later, well, if you need the comments on every line later, you might not want to be programming much. But even when you're first writing the code, if you comment each line, you're spending a rough estimate of 30-50% of your coding time writing comments. Not particularly efficient. That's not to say that spending a certain amount of time on commenting is bad, but there's such a thing as too much.

May 25th, 2006, 12:59 AM	#27
Jimbo Battle Programmer Join Date: Feb 2006 Location: Bellevue, WA, USA Posts: 769 Rep Power: 3	I'd say overcommenting is actually not good. While you can definitely see what your code does later, well, if you need the comments on every line later, you might not want to be programming much. But even when you're first writing the code, if you comment each line, you're spending a rough estimate of 30-50% of your coding time writing comments. Not particularly efficient. That's not to say that spending a certain amount of time on commenting is bad, but there's such a thing as too much.