[COFF] Code/comment Ratios Style
Chet Ramey via COFF
coff at tuhs.org
Tue Jul 22 00:27:57 AEST 2025
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 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/20250721/64589372/attachment.sig>
More information about the COFF
mailing list