I spent several of my last few days on my last job tidying up design documentation, javadoc, and header comments before leaving. Some parts of the header comment template were useless. How many hours was it worth to have me go through and label each file with its file name, author, and creation date? I doubt that in the year 3007, the historians of that time will be browsing millenium-old source code header comments to gain insight into our life and times. And if I’m wrong, they’ll probably do what we do now and check the repository change history. As it happens, a good CM system will keep track of who checked something in and when. Most astonishing of all, it’s quite easy to figure out the file name by… I dunno… looking at the name of the file on the file system? Believe me, I’m all for sensibly applied engineering rigor, but sometimes the wrong tool for the job just ought to be put back in the tool box.