Comments are essential as I've learned after being brought in to document/debug applications that were inherited by MIS/IT
One trick that I've learned that I never hear anybody discuss is onenote Now, before you go throwing rotten tomatoes, etc., go ahead and give it a try. Take every PRG and create a new page in one note for each. And add a page with each field name for each table (do it by the table as its easier to visualize) Once you have done that, you can enter anything you are trying to find and in a few moments you can see the big picture of where "anything" is used at, and it will help you to get up to speed pretty fast. -----Original Message----- From: ProFox [mailto:[email protected]] On Behalf Of Jeff Johnson Sent: Thursday, October 31, 2013 8:14 AM To: [email protected] Subject: Re: Is code self documenting? I comment my code. I've been working on some of the same code for over 20 years. Early on I commented the code where it is not clear what the code does. I also put comments in like, "* this needs to be refactored" Since I work on payroll for companies, when someone tells me to make a change I comment who authorized it and what date the change was made. The most amazing example of documentation is the Visual Maxframe framework. Drew Speedie's zreadme() method gives you everything you need to use a class. He also commented code in hook methods with example code that you could uncomment and use in the method. Also, when he used a line of code that maked no sense at all, he would tell you why he did it and what it does. It's all that documentation and comments that made it possible to get up to speed quickly to using that framework. For those that have used a framework, imagine what it would be like without the documentation. That's what you get when you use refox! Jeff --------------- Jeff Johnson [email protected] (623) 582-0323 www.san-dc.com www.arelationshipmanager.com On 10/30/2013 12:47 PM, Stephen Russell wrote: > http://visualstudiomagazine.com/articles/2013/06/01/roc-rocks.aspx > > Article is Why You Shouldn't Comment (or Document) Code > [excessive quoting removed by server] _______________________________________________ Post Messages to: [email protected] Subscription Maintenance: http://mail.leafe.com/mailman/listinfo/profox OT-free version of this list: http://mail.leafe.com/mailman/listinfo/profoxtech Searchable Archive: http://leafe.com/archives/search/profox This message: http://leafe.com/archives/byMID/profox/[email protected] ** 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.
