News for hackers. Stuff that matters.
Re:Fred P. Brooks has passed away by kwhitefoot on Friday November 18, 2022 @06:10AM (#33653065)
> sometimes the 'why' is about the code that wasn't written, so it can't possibly be in the code that was.

I have often had to write extensive comments related to this to prevent well meaning coders who are not expert in the domain from replacing the apparently bad or low performance code with an obvious but wrong 'improvement'.

Re:Fred P. Brooks has passed away by P5fRxh5kUvp2th on Friday November 18, 2022 @09:50AM (#33655512)
In a perfect world, tests and assertions would protect from that, but yes, that's a good use of comments.