Re: "Tricks" of the "Trade"
Re: "Tricks" of the "Trade"
- Subject: Re: "Tricks" of the "Trade"
- From: Brian Hill <email@hidden>
- Date: Thu, 7 Jun 2001 08:19:10 -0500
On Thursday, June 7, 2001, at 03:16 AM, Georg Tuparev wrote:
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?
If you don't get it, just go to Microsoft Dev Network and have some
really great time with comments ;-)
Well, Microsoft source code is an extreme example.
Hungarian Notation is the opposite of readable code. 8-)
I find that good comments read like stage directions in that they add to
the 'story'.
//exit stage left
email@hidden
http://personalpages.tds.net/~brian_hill
"Why? I came into this game for adventure - go anywhere, travel
light, get in, get out, wherever there's trouble, a man alone.
Now they've got the whole country sectioned off and you can't
move without a form. I'm the last of a breed."
-- Archibald "Harry" Tuttle, Rogue HVAC Repairman