<div dir="ltr"><div>IMO the skill of writing and maintaining good, useful comments is one of the things that distinguishes software engineering from mere programming.<br></div><div><br></div><div>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.<br></div><div dir="ltr"><br></div><div dir="ltr">On Sun, Jul 20, 2025 at 7:42 PM Larry McVoy <<a href="mailto:lm@mcvoy.com">lm@mcvoy.com</a>> wrote:</div><div class="gmail_quote gmail_quote_container"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><br>
Well, in a long lived code base, comments can rot.  I'd much rather have<br>
to read the code and figure it out than have a comment that is no longer<br>
true send me down a wild goose chase (it's happened more than I care to<br>
think about).<br>
<br></blockquote><div>True, and that is why I've always considered the comments to be an integral part of the code, and when doing code reviews I've refused to approve code changes where the comments are too sparse or where the comments don't match the code.</div><div><br></div><div>-Paul W. <br></div></div></div>