21 Jul
2025
21 Jul
'25
2:27 p.m.
On 7/21/25 10:24 AM, Paul Winalski wrote:
IMO the skill of writing and maintaining good, useful
comments is one of
the things that distinguishes software engineering from mere programming.
I learned early in my software engineering career that sometimes even after
a few months away from the code I wrote I couldn't remember all the fine
details of the design. So I wrote comments for my own self-preservation,
let alone giving another developer a fighting chance of knowing what's
going on if they had to change my code.
To answer the eternal question: what the hell were you thinking? :-)
--
``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/