XPost: alt.folklore.computers, comp.lang.python   
   From: invalid@invalid.invalid   
      
   Peter Flass  writes:   
   > I comment *A LOT*. When I had to go back and revisit some very old   
   > code, I wished I had commented more. I've almost never looked at a   
   > program and said "I wish it had fewer comments."   
      
   Regrettably, I’ve encountered plenty of comments that don’t actually   
   reflect the code (for a variety of reasons).   
      
   If the code is wrong and the comment is right then that’s great, you   
   have a nice hint about how to fix the code, assuming you realize there’s   
   a problem at all.   
      
   However if the code is right but the comment is wrong then the comment   
   is worse than nothing. The code would be improved by removing it   
   (although almost certainly improved even more by correcting it).   
      
   I’ve also encountered quite a few comments written by people who had   
   been instructed to add comments to under-commented code, but didn’t   
   really understand what they were looking at. The result generally   
   obscures more than it illuminates.   
      
   --   
   https://www.greenend.org.uk/rjk/   
      
   --- SoupGate-Win32 v1.05   
    * Origin: you cannot sedate... all the things you hate (1:229/2)