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). -- http://mail.python.org/mailman/listinfo/python-list
