Regarding coding style

[Roel Schroeven]

rockingred schreef:
> On Mar 8, 8:27 pm, Dan Bishop <danb... at yahoo.com> 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