Comments on: Writing and Programming – brothers in arms http://zwitserloot.com/2006/12/16/writing-and-programming-brothers-in-arms/ Tue, 16 Feb 2010 12:31:46 +0000 http://wordpress.org/?v=2.9.1 hourly 1 By: rzwitserloot http://zwitserloot.com/2006/12/16/writing-and-programming-brothers-in-arms/comment-page-1/#comment-723 rzwitserloot Sat, 16 Dec 2006 22:29:17 +0000 http://www.zwitserloot.com/2006/12/16/writing-and-programming-brothers-in-arms/#comment-723 "Code Smell"? Never heard that term before. I like it! “Code Smell”? Never heard that term before. I like it!

]]> By: Tim King http://zwitserloot.com/2006/12/16/writing-and-programming-brothers-in-arms/comment-page-1/#comment-721 Tim King Sat, 16 Dec 2006 17:47:01 +0000 http://www.zwitserloot.com/2006/12/16/writing-and-programming-brothers-in-arms/#comment-721 Hi, Reinier. Excellent point. I agree. In at least 90% of cases, a comment is a code smell. And when you do need them, comments should tell why a piece of code is there, but not what it does. If you feel you need to say what a block of code does or what a variable is for, you probably need to pick a better function or variable name. -TimK Hi, Reinier. Excellent point. I agree. In at least 90% of cases, a comment is a code smell. And when you do need them, comments should tell why a piece of code is there, but not what it does. If you feel you need to say what a block of code does or what a variable is for, you probably need to pick a better function or variable name.

-TimK

]]>