Comment of the day
-
I have to look up something in a co-worker's C# file. The lines are commented, but... some comments don't tell me anything :omg:
int anz,i; // used in various places... ... summe.FuvBeginnDatum = fuv.FuvBeginnDatum; // Must be the same! summe.VsuGuelBeg = fuv.FuvBeginnDatum; // Must be the same! ... summe.GtEintraege[0].GtGuelBeg = fuv.FuvBeginnDatum; // Must be like that!Now I'm going phone the author and let him explain why what must be like what... and hope he still knows :laugh: Lesson of the day: Never tell a programmer "you hav to comment your code". Tell him "you have to comment what your code does". :-DLOL :laugh: Maxwell Chen
-
I have to look up something in a co-worker's C# file. The lines are commented, but... some comments don't tell me anything :omg:
int anz,i; // used in various places... ... summe.FuvBeginnDatum = fuv.FuvBeginnDatum; // Must be the same! summe.VsuGuelBeg = fuv.FuvBeginnDatum; // Must be the same! ... summe.GtEintraege[0].GtGuelBeg = fuv.FuvBeginnDatum; // Must be like that!Now I'm going phone the author and let him explain why what must be like what... and hope he still knows :laugh: Lesson of the day: Never tell a programmer "you hav to comment your code". Tell him "you have to comment what your code does". :-DWhy don't you just send the Deadly Viper Assasination Squad? Phones are so complicated to use these days... Corinna John wrote: you have to comment what your code does Such people should be told to comment "what it's supposed to do". Then, debugging is merely a) finding discrepancies between code and comment and b) finding discrepancies between spec and comment so simple... :cool:
Flirt harder, I'm a Coder
mlog || Agile Programming | doxygen -
Why don't you just send the Deadly Viper Assasination Squad? Phones are so complicated to use these days... Corinna John wrote: you have to comment what your code does Such people should be told to comment "what it's supposed to do". Then, debugging is merely a) finding discrepancies between code and comment and b) finding discrepancies between spec and comment so simple... :cool:
Flirt harder, I'm a Coder
mlog || Agile Programming | doxygenpeterchen wrote: Deadly Viper Assasination Squad Where can I order an assassination, and what does it cost per programmer? Well, by now I have realised what all the loops are there for. I'll send him a link to the documentation of
Array.Copy. Positive thought of the day: When I'm finished cleaning up the class, it will be much easier to understand, might even run faster, and my collegue (who had been thrown into the windows-world after more than ten years of zOS programming) has a chance to learn a bit about style. Never give up :-D, coco -
peterchen wrote: Deadly Viper Assasination Squad Where can I order an assassination, and what does it cost per programmer? Well, by now I have realised what all the loops are there for. I'll send him a link to the documentation of
Array.Copy. Positive thought of the day: When I'm finished cleaning up the class, it will be much easier to understand, might even run faster, and my collegue (who had been thrown into the windows-world after more than ten years of zOS programming) has a chance to learn a bit about style. Never give up :-D, cocoDVAS contact here...[^] Corinna John wrote: Well, by now I have realised what all the loops are there for. I'll send him a link to the documentation of Array.Copy. :laugh: :omg: Corinna John wrote: When I'm finished cleaning up the class The most productive coder is the one who can *remove* a line of code without breaking the architecture or the user noticing.
Flirt harder, I'm a Coder
mlog || Agile Programming | doxygen -
peterchen wrote: Deadly Viper Assasination Squad Where can I order an assassination, and what does it cost per programmer? Well, by now I have realised what all the loops are there for. I'll send him a link to the documentation of
Array.Copy. Positive thought of the day: When I'm finished cleaning up the class, it will be much easier to understand, might even run faster, and my collegue (who had been thrown into the windows-world after more than ten years of zOS programming) has a chance to learn a bit about style. Never give up :-D, cocoReminds me of the comments of one of my former co-workers...
objConn.Open 'opens objConnHe also had a habit of copying and pasting secions of code instead of using a loop or recursive function. We used to take the mick from him constantly. :-O If I had a better memory I would remember more. -
Reminds me of the comments of one of my former co-workers...
objConn.Open 'opens objConnHe also had a habit of copying and pasting secions of code instead of using a loop or recursive function. We used to take the mick from him constantly. :-O If I had a better memory I would remember more.:laugh: no comment
-
I have to look up something in a co-worker's C# file. The lines are commented, but... some comments don't tell me anything :omg:
int anz,i; // used in various places... ... summe.FuvBeginnDatum = fuv.FuvBeginnDatum; // Must be the same! summe.VsuGuelBeg = fuv.FuvBeginnDatum; // Must be the same! ... summe.GtEintraege[0].GtGuelBeg = fuv.FuvBeginnDatum; // Must be like that!Now I'm going phone the author and let him explain why what must be like what... and hope he still knows :laugh: Lesson of the day: Never tell a programmer "you hav to comment your code". Tell him "you have to comment what your code does". :-DCorinna John wrote: // Must be like that! :laugh: :laugh: :~
Look at the world about you and trust to your own convictions. - Ansel Adams
Meg's World - Blog Photography -
I have to look up something in a co-worker's C# file. The lines are commented, but... some comments don't tell me anything :omg:
int anz,i; // used in various places... ... summe.FuvBeginnDatum = fuv.FuvBeginnDatum; // Must be the same! summe.VsuGuelBeg = fuv.FuvBeginnDatum; // Must be the same! ... summe.GtEintraege[0].GtGuelBeg = fuv.FuvBeginnDatum; // Must be like that!Now I'm going phone the author and let him explain why what must be like what... and hope he still knows :laugh: Lesson of the day: Never tell a programmer "you hav to comment your code". Tell him "you have to comment what your code does". :-DEric Lippert posted about another story like this the other day, referring to "comment rot" :) http://blogs.msdn.com/ericlippert/archive/2004/05/04/125893.aspx Marcie CP Blog[^]
-
peterchen wrote: Deadly Viper Assasination Squad Where can I order an assassination, and what does it cost per programmer? Well, by now I have realised what all the loops are there for. I'll send him a link to the documentation of
Array.Copy. Positive thought of the day: When I'm finished cleaning up the class, it will be much easier to understand, might even run faster, and my collegue (who had been thrown into the windows-world after more than ten years of zOS programming) has a chance to learn a bit about style. Never give up :-D, cocoCorinna John wrote: my collegue (who had been thrown into the windows-world after more than ten years of zOS programming) has a chance to learn a bit about style. Your patience is commendable!:-D Some people think of it as a six-pack; I consider it more of a support group.
-
Eric Lippert posted about another story like this the other day, referring to "comment rot" :) http://blogs.msdn.com/ericlippert/archive/2004/05/04/125893.aspx Marcie CP Blog[^]
Eric makes some excellent points! Some people think of it as a six-pack; I consider it more of a support group.
-
I have to look up something in a co-worker's C# file. The lines are commented, but... some comments don't tell me anything :omg:
int anz,i; // used in various places... ... summe.FuvBeginnDatum = fuv.FuvBeginnDatum; // Must be the same! summe.VsuGuelBeg = fuv.FuvBeginnDatum; // Must be the same! ... summe.GtEintraege[0].GtGuelBeg = fuv.FuvBeginnDatum; // Must be like that!Now I'm going phone the author and let him explain why what must be like what... and hope he still knows :laugh: Lesson of the day: Never tell a programmer "you hav to comment your code". Tell him "you have to comment what your code does". :-D -
Reminds me of the comments of one of my former co-workers...
objConn.Open 'opens objConnHe also had a habit of copying and pasting secions of code instead of using a loop or recursive function. We used to take the mick from him constantly. :-O If I had a better memory I would remember more.Suzanne Boyle wrote: take the mick OK, I give up. I'm the ignorant American. What does the expression 'take the mick' mean?
Software Zen:
delete this; -
Suzanne Boyle wrote: take the mick OK, I give up. I'm the ignorant American. What does the expression 'take the mick' mean?
Software Zen:
delete this;It is slang and means to ridicule someone. Ant.