Re: [pygame] Free chapter of my book

[Kamilche <kamilche@xxxxxxxxxxxx>]

Ken Seehart wrote:
>   Will McGugan wrote:
> > Horst JENS wrote:
> > > > I think that either the comment should say "in 10 frames"
> > > > or the randint statement should be randint(1,10).
> > > >     
> > > correction:
> > >
> > > or the ranint statement should be randint(1,20)
> > >
> > >   
> > Ack! Well spotted. Never hard code values in to comments!
> >
> > Will
> A former employee where I work once said that it's better not to comment 
> at all because all comments are fundamentally redundant and might become 
> inconsistent with the code.  He proceeded to remove all comments.  
> Naturally, he was a perl programmer :-)
>
> Ken
Well, inconsistent comments are the worst. But as a broad overall 'what 
this area is supposed to do' bit, they're handy. When I'm tired, and 
looking for a spot to update, I tend to skim the comments until I hit 
the right area. I've been fooled by bad comments myself, tho, it happens 
sometimes. Comments should never be too specific.

--Kamilche