[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