[COFF] Code/comment Ratios Style

Chet Ramey via COFF coff at tuhs.org
Mon Jul 21 10:58:19 AEST 2025


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 find that I'm not nearly as clever as my younger self.

Detailed change log entries are essential as well.

Chet

-- 
``The lyf so short, the craft so long to lerne.'' - Chaucer
		 ``Ars longa, vita brevis'' - Hippocrates
Chet Ramey, UTech, CWRU    chet at case.edu    http://tiswww.cwru.edu/~chet/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: OpenPGP_signature.asc
Type: application/pgp-signature
Size: 203 bytes
Desc: OpenPGP digital signature
URL: <http://www.tuhs.org/pipermail/coff/attachments/20250720/433eaac0/attachment-0001.sig>


More information about the COFF mailing list