rockingred schreef: > On Mar 8, 8:27 pm, Dan Bishop <[EMAIL PROTECTED]> wrote: >> // Copyright (C) 2008 Foobar Computer Consulting >> // >> // VERSION PROJECT# DATE DESCRIPTION >> // ------- -------- -------- ------------------ >> // 1.00 123456 01/04/08 Original creation. >> // >> >> Eleven lines, of which the only useful information to me was the >> project number, as knowing this let me look up who was behind these >> comments. > > Actually, "editorial" comments that tell you who last changed a > program, when and why can be useful. I worked in a company with a > number of programmers on staff. Having comments that told us Joe > worked on a program yesterday that isn't working today could often > solve half the battle. Especially if Joe also added a comment near > the lines he had changed. Likewise including the "Project#" would > help us track all the programs that had to be changed for a specific > project. This allowed us to move all related items into the Live > system once the testing phase had been completed (we just searched for > everything with the same Project# in it). Yes, on rare occasions we > would have an entire page of "Editorial" comments to ignore at the > beginning of our program listing, but it was easy enough to skip that > page. I will grant you that probably after 10 changes the first > change isn't as important anymore (unless you want to backtrack and > find out who started the Project in the first place and what it's > original purpose was).
That is certainly useful, but IMO that's what version control systems are for. -- The saddest aspect of life right now is that science gathers knowledge faster than society gathers wisdom. -- Isaac Asimov Roel Schroeven -- http://mail.python.org/mailman/listinfo/python-list
