Comments are always a good thing, particularly ones that follow a structured syntax such as Javadoc. I admit there is no need to comment EVERYTHING such as:
//increment x by 1
but if the code starts going into complex recursion or is the interpretation of a complex equation then codes should provide all the help they can give.
I wrote a statistical equation a while back and it wasn't until much later that a statistician could highlight the incorrect part when it produced erroneous results. This statistician doesn't understand any programming language (save SAS) but because I had commented in the right areas he was quick to point out the flaw.
I'm quick to admit that I am not the world's most competent programmer so I rely heavily on comments to inform me what each and every method does. I get incredibly frustrated when I can't pick the most appropriate method for the situation simply because the author was too lazy to write a few extra lines.
4 posts • joined Thursday 13th December 2007 13:55 GMT
So eat loads of fish
Woopee! More fish fingers for me!
Help for all
Comments are always a good thing, particularly ones that follow a structured syntax such as Javadoc. I admit there is no need to comment EVERYTHING such as:
//increment x by 1
but if the code starts going into complex recursion or is the interpretation of a complex equation then codes should provide all the help they can give.
I wrote a statistical equation a while back and it wasn't until much later that a statistician could highlight the incorrect part when it produced erroneous results. This statistician doesn't understand any programming language (save SAS) but because I had commented in the right areas he was quick to point out the flaw.
I'm quick to admit that I am not the world's most competent programmer so I rely heavily on comments to inform me what each and every method does. I get incredibly frustrated when I can't pick the most appropriate method for the situation simply because the author was too lazy to write a few extra lines.
"and wished Barnes "a full and speedy recovery" from his unspecified injuries."
... so he can stand up and get hit again. Next!
Clearly being made by Apple
...they'll release a black version soon enough.
I wonder where the iPod goes?