|
In a recent CP newsletter, the following article link was supplied: Why comments are stupid, a real example
After careful consideration, I offer the following comments:
# IDIOT
| "The difference between genius and stupidity is that genius has its limits." - Albert Einstein | | "As far as we know, our computer has never had an undetected error." - Weisert | | "If you are searching for perfection in others, then you seek disappointment. If you are seek perfection in yourself, then you will find failure." - Balboos HaGadol Mar 2010 |
|
|
|
|
|
Ah but you forget
Rem IDIOT
; IDIOT
Geek code v 3.12
GCS d--- s-/++ a- C++++ U+++ P- L- E-- W++ N++ o+ K- w+++ O? M-- V? PS+ PE- Y+ PGP t++ 5? X R++ tv-- b+ DI+++ D++ G e++>+++ h--- r++>+++ y+++*
Weapons extension: ma- k++ F+2 X
I use 1TBS
|
|
|
|
|
Ahh - but the Lounge is supposed to be KSS . . .
so I need to watch my language;
| "The difference between genius and stupidity is that genius has its limits." - Albert Einstein | | "As far as we know, our computer has never had an undetected error." - Weisert | | "If you are searching for perfection in others, then you seek disappointment. If you are seek perfection in yourself, then you will find failure." - Balboos HaGadol Mar 2010 |
|
|
|
|
|
And
Bad command or file name. Bad, bad command! Sit! Stay! Staaaay...
|
|
|
|
|
|
There's no halting for idiotic comments
|
|
|
|
|
You are wise in the ways of the force! +5
| "The difference between genius and stupidity is that genius has its limits." - Albert Einstein | | "As far as we know, our computer has never had an undetected error." - Weisert | | "If you are searching for perfection in others, then you seek disappointment. If you are seek perfection in yourself, then you will find failure." - Balboos HaGadol Mar 2010 |
|
|
|
|
|
Indeed! 
You have just been Sharapova'd.
|
|
|
|
|
|
No comments! 
Anything that is unrelated to elephants is irrelephant
Anonymous
-
The problem with quotes on the internet is that you can never tell if they're genuine
Winston Churchill, 1944
-
I'd just like a chance to prove that money can't make me happy.
Me, all the time
|
|
|
|
|
Just read his book, Soft Skills, which is pretty good though.
Luckily it isn't about code 
|
|
|
|
|
He isn't, by some chance, the same person who can do it quicker from "Apparently the customer knows best... " post, is he?
Also, couldn't his article be considered a commentary - and thus self referential?
| "The difference between genius and stupidity is that genius has its limits." - Albert Einstein | | "As far as we know, our computer has never had an undetected error." - Weisert | | "If you are searching for perfection in others, then you seek disappointment. If you are seek perfection in yourself, then you will find failure." - Balboos HaGadol Mar 2010 |
|
|
|
|
|
W∴ Balboos wrote: He isn't, by some chance, the same person who can do it quicker from "Apparently the customer knows best... " post, is he?
No way!
W∴ Balboos wrote: Also, couldn't his article be considered a commentary - and thus self referential?
The page didn't redirect to StackOverflow, so... I guess not 
|
|
|
|
|
Serious bit:
I comment prior to coding. I will write psudo code in comments and then I can see what needs to be filled in and oft is the time these comments disappear altogether.
-- or --
/**
IDIOT!
*/
veni bibi saltavi
|
|
|
|
|
Here's my attitude:
Not writing comments, under the presumption that the coding is so clear that it explains itself, falls into the category of debugging your own applications.
What's perfectly clear and obvious to one person may be gibberish to another. And, there are occasions when I do something that's just not how I'd want to do it. What better place to explain "why?" than at the scene of the crime?
Brilliant as some of us may be - if one really knows what they're doing then they can explain it.
My fearless leader (i.e., IT Director) only writes (shudder!) VB6 for apps (he's a DBA). Currently we're in a php/javaScript/HTML phase and I comment everything. He's able to cut/paste it, even though he can't quite read it, and make good use of it without needing to bother me. If I could just get him to learn a real language . . . but that's another subject.
| "The difference between genius and stupidity is that genius has its limits." - Albert Einstein | | "As far as we know, our computer has never had an undetected error." - Weisert | | "If you are searching for perfection in others, then you seek disappointment. If you are seek perfection in yourself, then you will find failure." - Balboos HaGadol Mar 2010 |
|
|
|
|
|
W∴ Balboos wrote: Currently we're in a php/javaScript/HTML phase
W∴ Balboos wrote: If I could just get him to learn a real language
giggles
veni bibi saltavi
|
|
|
|
|
Nagy Vilmos wrote: giggles
What a great name for a programming language!
From where can I download the compiler?
I wanna be a eunuchs developer! Pass me a bread knife!
|
|
|
|
|
... may not make sense even to yourself at a later time.
I like to think that
- comments above a method/class/property tell you what is its purpose or goal, and any implied contract on the state of input parameters.
- comments in the method tell you why you are doing something, with emphasis on warnings, subtle issues, or warnings about dragons
- the code should read like a story, but it is only telling you how you are doing whatever you are trying to accomplish, not the reason for it.
You write code for the programmers that come after you to fix/modify the functionality/performance of your code. It might be you next week, next month, 5 years from now.
Computers read binary.
|
|
|
|
|
W∴ Balboos wrote: Not writing comments, under the presumption that the coding is so clear that it explains itself, falls into the category of debugging your own applications.
Ah! You've caught me! I've been the only developer working in our code for most of the last 15 years, and comments are few and far between. In my mind, the code is self-explanatory and I have no problem (usually) of understanding it.
Now, we are hiring an intern for the summer who will be converting this legacy code into .NET and I'm now cringing at what probably will be fairly difficult for a newbie to read and comprehend.  I'm hoping that my descriptive variable/method/function names read well enough for him to make sense of it, otherwise, I'm sure to be explaining it. I'll also need to lay down the rules for commenting in the new development. 
"Go forth into the source" - Neal Morse
|
|
|
|
|
Indeed. How often I have seen some more or less readable code which actually told me what is being done, but not a single clue why it's being done and what it is supposed to accomplish.
Only a master of the obvious writes comments that tell us what is going on.
The language is JavaScript. that of Mordor, which I will not utter here
This is Javascript. If you put big wheels and a racing stripe on a golf cart, it's still a f***ing golf cart.
"I don't know, extraterrestrial?"
"You mean like from space?"
"No, from Canada."
If software development were a circus, we would all be the clowns.
|
|
|
|
|
How could you all forget:
C IDIOT
(FORTRAN)
If you have an important point to make, don't try to be subtle or clever. Use a pile driver. Hit the point once. Then come back and hit it again. Then hit it a third time - a tremendous whack.
--Winston Churchill
|
|
|
|
|
So I have to make a little something for a customer.
Basically they want to name a stored procedure and all of its parameters in the database after which a user can select a procedure in the application, fill in values for the parameters and have the data shown in a grid.
So we have dynamic types (for parameters) with dynamic default values, dynamic forms, dynamic results, etc.
Still, no problem. So I gave a estimate of three to four days for the entire thing.
I get an email from the customer asking me to explain why it would take so long. His experience taught him it would take two days max.
So I explained I need to have a little room for issues (I'm working in the customer's software, with third party tools, that aren't completely known to me), that I need to test, and that working with all that dynamic data can be tricky.
I get another email back "In my experience working on this kind of solution isn't tricky at all!"
So why have me do it then? 
I already ran into an issue and his proposed solution wasn't going to work. That's half a day on 'issues' already! 
|
|
|
|
|
You have forgotten management rule 47:- everything I don't know how to do is easy
You cant outrun the world, but there is no harm in getting a head start
Real stupidity beats artificial intelligence every time.
|
|
|
|
|
Sounds like a Dilbert thing
|
|
|
|
|
doesn't make it untrue
You cant outrun the world, but there is no harm in getting a head start
Real stupidity beats artificial intelligence every time.
|
|
|
|
General 
News 
Suggestion 
Question 
Bug 
Answer 
Joke 
Praise 
Rant 
Admin 
Submit an article or tip
