Re: Encouraging good comments Which language ?

[Petite Abeille <petite.abeille@...>]

On Jan 30, 2012, at 4:36 PM, Axel Kittenberger wrote:

> albeit objectively the total utility would be
> far greater with comments, since they are little investment to the one
> but great benefit of the other

If that's the case, then, the one benefiting from the comments should take care of writing, using and maintaining them. You know, for the greater good. In which case everybody incentives will be aligned: clear code leads to meaningful comment which brings good documentation, demonstrating clarity of thought and purpose, etc, etc, ...