Mike Ford wrote: >> -----Original Message----- >> From: Jeff Harris [mailto:[EMAIL PROTECTED] >> Sent: 07 July 2003 23:27 >> >> After coding for a while, I would suggest that while you're reading >> through coding excercises, you find a coding style that works >> for you and >> keep it consistant. One of the least fun parts of creating >> your php pages >> is reading some code that you coded months (years) ago, and >> it's totally >> out of style with everything else that you're doing. > > H'mm, yes -- reminds me of the following, which someone taught me in > the dim-and-distant past and I'm constantly quoting to people who > don't adequately comment code: > > "Someone else's code: code written by someone else, or code written > by you more than 6 months ago".
And the corollary to is: Most of what constitutes value in commented code is the code itself, which exhibits well-named variables, methods, etc. and well-structured, well-encapsulated algorithms. When code is structured appropriately, then the only actual comments needed are to explain unusual logic or business rules that cannot be easily deciphered from reading the code. Steve -- Steve Magruder Consulting - http://consulting.stevemagruder.com -- PHP General Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
