Comments on: Self-Documenting Code… Interesting thoughts about comments… http://www.beilers.com/2009/11/self-documenting-code-interesting-thoughts-about-comments/ Crazy Thoughts on Software Development and Life in General Wed, 21 Jul 2010 17:31:27 +0000 hourly 1 http://wordpress.org/?v=3.0 By: Jennifer http://www.beilers.com/2009/11/self-documenting-code-interesting-thoughts-about-comments/comment-page-1/#comment-2722 Jennifer Wed, 25 Nov 2009 15:13:11 +0000 http://www.beilers.com/?p=604#comment-2722 I am a big believer in comments to detail how or when to use the code. But I truly hate poorly written comments and especially comments that have been cut and pasted from somewhere else and are just plain wrong. I do believe comments are evil unless they are clear, simple, and CORRECT. I liked the "10 commandments" article. I'm a little surprised that he doesn't mention anything about having a design outlined before you start coding. I am a big believer in comments to detail how or when to use the code. But I truly hate poorly written comments and especially comments that have been cut and pasted from somewhere else and are just plain wrong. I do believe comments are evil unless they are clear, simple, and CORRECT.

I liked the “10 commandments” article. I’m a little surprised that he doesn’t mention anything about having a design outlined before you start coding.

]]>