in reply to Re: Re: Commenting: What about PDL?
in thread Commenting: What about PDL?

Actually the opinions are not quite so orthogonal as that. I would agree that initially maintainance will be very much helped by the PDL comments. However they won't age so well. As a result experienced programmers are likely to instinctively distrust those nice beautiful comments.

This ageing process is not instantaneous, it is a creeping issue that comes over multiple rounds of aging. There is no clear point at which you know that the comments are now bad, it is a gradual process.

Which is why I suggested making the pdl into function names rather than comments. Because function names are active code, are likely to get maintained with the code.

  • Comment on Re (tilly) 3: Commenting: What about PDL?