21 Jul
2025
21 Jul
'25
12:58 a.m.
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(a)case.edu http://tiswww.cwru.edu/~chet/