> -----Original Message----- > From: profoxtech-boun...@leafe.com [mailto:profoxtech-boun...@leafe.com] > On Behalf Of Ken Kixmoeller f/h > Sent: Thursday, April 08, 2010 12:24 PM > To: profoxt...@leafe.com > Subject: Re: Comments are there too many or should syntax explain it all? > <snipped>
> Problem for me is that even nice, long, self-explanatory variable names > and a "self-evident" program flow make *lots* of sense when one is > creating it. Three years later: "WTF?" > What gives me great joy is to come across an older yet well documented piece of code, with liberal comments describing the situation and design ideas, and why things are the way they are.... (anyone ever seen something in the middle of some code similar to IF Invoice_No <> "8277A" ???)... Then code changes take place and comments are equally good, but then CONTRADICT the previous comments so you don't know which is correct anymore... Thanks, Matthew Jarvis || Business Systems Analyst IT Department McKenzie-Willamette Medical Center 1460 G Street, Springfield, OR 97477 || Ph: 541-744-6092 || Fax: 541-744-6145 -------------------------------------------------------------------------- Disclaimer: This electronic message may contain information that is Proprietary, Confidential, or legally privileged or protected. It is intended only for the use of the individual(s) and entity named in the message. If you are not an intended recipient of this message, please notify the sender immediately and delete the material from your computer. Do not deliver, distribute or copy this message and do not disclose its contents or take any action in reliance on the information it contains. _______________________________________________ Post Messages to: ProFox@leafe.com Subscription Maintenance: http://leafe.com/mailman/listinfo/profox OT-free version of this list: http://leafe.com/mailman/listinfo/profoxtech Searchable Archive: http://leafe.com/archives/search/profox This message: http://leafe.com/archives/byMID/profox/69f310c05dd83c48a84ba3769ce1ecf8030b1...@tntriexevs02.triadhospitals.net ** All postings, unless explicitly stated otherwise, are the opinions of the author, and do not constitute legal or medical advice. This statement is added to the messages for those lawyers who are too stupid to see the obvious.