Re: "Tricks" of the "Trade"
Re: "Tricks" of the "Trade"
- Subject: Re: "Tricks" of the "Trade"
- From: Nat! <email@hidden>
- Date: Thu, 7 Jun 2001 16:24:58 +0200
Am Donnerstag, 7. Juni 2001 um 10:16 schrieb Georg Tuparev:
On Thursday, June 7, 2001, at 09:33 AM, Erik Thorteran wrote:
I disagree that commenting is a "deoderant" for smelly code. I use it
always, as it is not compiled. i do it just to make sure that I
understand what I was thinking an ungodly hour like now. However I do
agree with your places where you do put comments. i figure,
commenting ain't so hard, might be useful, and takes no performance
toll, so what the hell?
Let the code speak! The code IS the ultimate truth! Comments are
getting out of sync, getting obsolete. And they they slow down the
reading of the program -- imagine a book that contains two stories at
the same time - one sentence from the first story (the code) and the
next from the second story (comments). Is this fun to read?
Hmm, something like the tractatus logico-philosophicus without a
commentary is no fun to read either. Actually a pretty nice analogy. The
general problem is that people like to comment the stuff that is hard
for them. Beginners find lots of stuff hard and therefore like a lot of
comments. Pros find almost nothing hard, and see comments get into their
way. As a philosophy beginner you certainly will appreciate a
commentary, as a philopsoph professor you will just hate the commentary,
because its just restating what you already read and probably even
partly wrong :)
So my point of view, don't be religious over comments.
Nat!