Actually - I duplicate the code to be changed - then comment the 1st version and then modify the 2nd copy. And, I put my initials & date above the 1st set of commented code.
Understand - we have lots of different clients - and many of them have highly customized systems - and its those customizations I am commenting. -K- -----Original Message----- From: profoxtech-boun...@leafe.com [mailto:profoxtech-boun...@leafe.com] On Behalf Of Ricardo Aráoz Sent: Thursday, April 08, 2010 3:22 PM Kurt Wendt wrote: > I've started to add more comments into my code - since I know that some > of the other programmers here will be totally dumb-founded when they > look at some of the code I did recently - as I made some complex code to > handle a complex invoicing problem. But, even before that - I started to > make brief comments in the code - for things that I change. Too bad the > other don't do that - as one of them broke this program the other day - > and "Browse" came up empty after something they did. If they HAD simply > marked their initials and the date - I would have IMMEDIATELY spotted > their code change! But, of course - they did not... > I've seen that practice. Don't like it. Much prefer a good version control system and a good diff tool. Comments with initials and date will only clutter your program and you'll never really know what was done and what was the state of the code before. _______________________________________________ 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/289ea162f5642645b5cf64d624c66a14071a1...@us-ny-mail-002.waitex.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.
