[COFF] Code/comment Ratios Style

[Stuff Received]

On 2025-07-20 20:58, Chet Ramey via COFF wrote:
> On 7/20/25 5:26 PM, Warren Toomey via COFF wrote:
> 
>> So this isn't a rant so much as a request for alternate perspectives. If
>> you have a spartan commenting style, why? Can you read your code and see
>> all the implications, or do you dislike lots of comments, or do you write
>> more external documentation etc.?
> 
> I think the age of my code base stacks up pretty well, and I find myself
> commenting what I think are the complex parts and changes very heavily.
> Above all, I want to be able to answer this question from my future self:
> what the hell were you thinking?

I concur with this.  Some of the code we wrote was highly optimized 
mathematical code that was far from easy to understand.  Separate 
documents helped but methinks our former use of noweb was better.

> I find that I'm not nearly as clever as my younger self.

+1

S.

> Detailed change log entries are essential as well.
> 
> Chet
>