[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