do you comment your code ?

hyperian said:
I like to read comments in english generally. Anyone ever had to deal with afrikaans variable names and comments?
Click to expand...

I can handle the Dutch, but when the guys starting mixing Afrikaans and Brits, I mean English, it really pees me. Got one guy at work that does that and I hate it when I work on his cr@p.
 
cbrunsdonza said:
I can handle the Dutch, but when the guys starting mixing Afrikaans and Brits, I mean English, it really pees me. Got one guy at work that does that and I hate it when I work on his cr@p.
Click to expand...

Yea, these guys usually went to some afrikaans varsity and learned their **** there. Which is irratating because I reckon 90% of people comment in english anyway.

What really pisses me off though (as you pointed out) is that some people can't decide on a format/standard and stick with it. I'm physically looking at someone right now that has 3 different ways of using dates in his code.... 3.... when I specifically instructed him there should only be one. Same thing with his stored procedure code and OMG, the other day I found this:

sql = Replace(sql,"''","NULL")

Yes (VBScript) and you just read right. He replaces double single quotes with the word NULL. No. I'm not kidding. He doesn't bother replacing single quotes with double single quotes, he only replaces that, with the word... null...

And the comments he put on? a copy and paste of my work. Didn't even bother to post the author name or who changed it

Going through all his code to fix all the mistakes/bugs he introduced took me as long as it would've taken me to write the whole damn thing!

I'm at a point where I'm almost convinced he outsources the work he does to his cousin in india or something hence the huge ****ing difference between his code and how it looks like all the time
 
AcidRaZor said:
Yea, these guys usually went to some afrikaans varsity and learned their **** there. Which is irratating because I reckon 90% of people comment in english anyway.

What really pisses me off though (as you pointed out) is that some people can't decide on a format/standard and stick with it. I'm physically looking at someone right now that has 3 different ways of using dates in his code.... 3.... when I specifically instructed him there should only be one. Same thing with his stored procedure code and OMG, the other day I found this:

sql = Replace(sql,"''","NULL")

Yes (VBScript) and you just read right. He replaces double single quotes with the word NULL. No. I'm not kidding. He doesn't bother replacing single quotes with double single quotes, he only replaces that, with the word... null...

And the comments he put on? a copy and paste of my work. Didn't even bother to post the author name or who changed it

Going through all his code to fix all the mistakes/bugs he introduced took me as long as it would've taken me to write the whole damn thing!

I'm at a point where I'm almost convinced he outsources the work he does to his cousin in india or something hence the huge ****ing difference between his code and how it looks like all the time
Click to expand...

i trust you had something strong before or after that ;)

on this matter is why i spesifically thought, hey sometimes it might be better to be the noob rather than the senior, then at least you don't have to take a dive though the drivels, but now alas as the senior heh well just take a strong grog™ or coffee it might help.
 
Last edited:
Ok, someone has to say it...

Real™ Programmers don't comment their code. If it was hard to write, it should be hard to understand.

:)

I prefer XML comments for platforms that support it, and /* intro comments */ for others. Then I generally put a //single line comment explaining what the next block of code does.
 
LOL AcidRaZor, I nearly spilled my coffee.

I see the same cr@p on my side. I too started off at the bottom and have written my share of bad code, but what gets me when the guy with 3 times my "experiencing", earning more than double my salary write worse code than what I did when I was 10.

I ended saying to one guy that I will take over his code. I just rewrote it all one Friday morning - took me days before to figure it out.

Another moan is people that do not know how to write SQL. If ever there where a self documenting language then SQL is it.
 
if code in our place is not commented, or commit comments are properly done. You get a warning lol.
 
You must log in or register to reply here.
Back
Top
Sign up to the MyBroadband newsletter
X