|
Fortunately for me, our coding standard (all 1½ pages of it) hasn't changed significantly since 2000.
Software Zen: delete this;
|
|
|
|
|
The comment was removed shortly thereafter. The "user termination" logic was directly after the comment, but was moved into its own method. This was part of a reorganization/refactoring going on in preparation for a new feature.
Software Zen: delete this;
|
|
|
|
|
The best comment is a removed comment  
|
|
|
|
|
A long time ago I took a programming class from Dan Saks, one-time secretary of the ISO C++ standardization committee. He said something to us which has stuck with me ever since, and has led to a profound reduction in the number of comments I write:
"If you can, say it in code. If you can't, only then say it in a comment."
While we do maintain change history in our source, my comments now tend to serve other purposes than simple documentation. For example, our code base is in the neighborhood of 3 million lines so navigation can be a problem. Comments can serve as markers for 'find in files' destinations when Intellisense doesn't work.
Software Zen: delete this;
|
|
|
|
|
One of my mentors once stated
"The comments are the part of the code that even the compiler cannot understand"
|
|
|
|
|
I do similar. Private members have leading underscores in my code.
I was just yanking Sander's chain.
When I was growin' up, I was the smartest kid I knew. Maybe that was just because I didn't know that many kids. All I know is now I feel the opposite.
|
|
|
|
|
honey the codewitch wrote: yanking Sander's chain
Chain-yanking is almost always a useful thing.
Software Zen: delete this;
|
|
|
|
|
I find the comment more problematic.
But it's good that I instill fear in those that write code of dubious quality*
* The quality of code shall be measured by braceless single line if statements, indentation, lack or abundance of white space, naming conventions and comments.
Whether the code does what it should do is of secondary concern.
Code written in Java shall be considered bad quality by default.
|
|
|
|
|
see, I used to care about that stuff.
now it's (re other people's code)
a) does the code do what it's supposed to?
b) can i read it?
i guess i've gotten good at b because i'm fine with just about whatever.
When I was growin' up, I was the smartest kid I knew. Maybe that was just because I didn't know that many kids. All I know is now I feel the opposite.
|
|
|
|
|
Technically is just a line of code.
-- Carlo The Nitpick
|
|
|
|
|
Software Zen: delete this;
|
|
|
|
|
There's no such thing as a "line of code" in C-style languages.
|
|
|
|
|
You mean I've spent all these years doing... nothing? 
Software Zen: delete this;
|
|
|
|
|
The function name is clear enough, is the comment necessary? 
|
|
|
|
|
And I thought the problem was:
_Users_Terminate( IgnoreUser=Me ); // Bug found that after terminating my user, program stopped...
|
|
|
|
|
10 PRINT "WEEEEEE",
20 GOTO 10
|
|
|
|
|
A tad BASIC, but sounds like fun.
Software Zen: delete this;
|
|
|
|
|
Do tall people sleep longer in bed?
Sent from my Amstrad PC 1640
Never throw anything away, Griff
Bad command or file name. Bad, bad command! Sit! Stay! Staaaay...
AntiTwitter: @DalekDave is now a follower!
|
|
|
|
|
Yep, it helps to give then a better altitude for their workday.
"the debugger doesn't tell me anything because this code compiles just fine" - random QA comment
"Facebook is where you tell lies to your friends. Twitter is where you tell the truth to strangers." - chriselst
"I don't drink any more... then again, I don't drink any less." - Mike Mullikins uncle
|
|
|
|
|
Rumor has it that's just a tall tale.
/ravi
|
|
|
|
|
Rumors are just short stories without any proof
Message Signature
(Click to edit ->)
|
|
|
|
|
Ahh, the lengths we go for puns.
"the debugger doesn't tell me anything because this code compiles just fine" - random QA comment
"Facebook is where you tell lies to your friends. Twitter is where you tell the truth to strangers." - chriselst
"I don't drink any more... then again, I don't drink any less." - Mike Mullikins uncle
|
|
|
|
|
A measure by any other yardstick, and we're not an inch closer.
/ravi
|
|
|
|
|
Wow, that gives me pause to think, but not furlong.
"the debugger doesn't tell me anything because this code compiles just fine" - random QA comment
"Facebook is where you tell lies to your friends. Twitter is where you tell the truth to strangers." - chriselst
"I don't drink any more... then again, I don't drink any less." - Mike Mullikins uncle
|
|
|
|
|
That's a bit of a stretch
“The palest ink is better than the best memory.” - Chinese Proverb
|
|
|
|
General 
News 
Suggestion 
Question 
Bug 
Answer 
Joke 
Praise 
Rant 
Admin 
Submit an article or tip
