Slashdot Mirror
How to Write Comments
Denis Krukovsky writes "Should I write comments? What is a good comment? Is it possible to comment a class in 5 minutes? See "
Everybody knows that good code is self documenting- which is why my prof in college demanded we write in Ada. I instead suggest commenting in haiku.
You call that news? Plus I never thought that writing comments in code was such a big issue. i mean, we all know that it's important to have code commented so we easily understand what the code is for, but I don't think that it's necessary to make a page explaining how to write good comments, everybody instinctively knows how to write short and pertinent comments, i think..
You just got troll'd!
"I don't. I see them occasionally. You're either surrounded by complete idiots, or elite programmers making jokes that are flying above your head."
Or perhaps you are making stupid assumptions. Yes, I deal with alot of shitty code, most of it open source and written by people I have never even met. The people I am surrounded by are not making the comments, the mass of assorted dumbasses all over the world are. But of course, it must be just me and that wacky nut Rob Pike, we're both such shitty programmers that our experiences would be irrelivant.
As for the rest of your post, you just like to argue it seems. You are reading into his words and mine the intent you would like to see, simply so you can disagree with it. Since you don't actually need anyone else for this, why not just go make up both sides to an argument on your own?
Quoting a dumbass who refuses to read what he replies to:
"I assume all these people are now working with you and Rob Pike."
Quoting the post you replied to, and even quoted:
"The people I am surrounded by are not making the comments, the mass of assorted dumbasses all over the world are."
"If you think Pike is for comments, perhaps you can point out what paragraph actually encourages commenting in his article,"
I already did, remember:
"Almost exclusively, I use them as an introduction to what follows. Examples: explaining the use of global variables and types (the one thing I always comment in large programs); as an introduction to an unusual or critical procedure; or to mark off sections of a large computation."
But obviously reading what you reply to takes WAY too much effort.