The Scary Door

Learn along with me, Brunhilde the happy programmer!

2.5.05

Commenting on comments

I brought up the program I made the other day to show my supervisor what I had been doing and as it was loading I mentioned to him that I had done of good job of commenting this source and that it was going to be a stunning example of well commented code.

When it loaded we both looked at it, then looked at each other, him with a 'what are you talking about?' look on his face, and me probably looking guilty as a comment-less screen stared at us.

"Wait wait, I'll scroll up. See? There they are!"

He said that was a very nice effort, but five comment lines in one hundred lines of code do not equal well commented code.

It felt like a lot when I was writing it!

Though no one here really comments their code very much, I suppose when there are only three programmers it isn't that hard to have everyone understanding what is going on, and if not you can just ask the person who wrote it. Most things seem so straightforward when I code them that putting in comments seems pointless. The ones I had put into this particular program were mostly there for my own benefit, so I could see what steps had been programmed in and what was still needed.

I wonder if properly commenting your code if a necessary practice in big companies?

2 Comments:

At 5/2/10 11:19, Anonymous Anonymous said...

Order [url=http://buy-cialis.icr38.net/Suprax]suprax online[/url] now - Incredible Chance klonopin online now - Ultimate Chance

 
At 16/3/10 03:21, Anonymous Anonymous said...

lSymfwdTRI American Family Insurance ba4FI9vMKY Delta Dental Insurance jupLFlRn4 Health Insurance Coverage ECVyZ5a73 Online Car Insurance TJiYrxE51 Cigna Dental Insurance seP4XDqIKY prudential insurance BA8QPi3VT cigna dental insurance A0iUx1LIQ cheap insurance

 

Post a Comment

<< Home