News for hackers. Stuff that matters.
Re:Show HN: I wrote a full text search engine in Go by ok_dad on Thursday October 09, 2025 @07:54PM (#45534226)
I like it, I comment exactly like you do. Comments are free, storage is plentiful, why not add comments everywhere?!
Re:Show HN: I wrote a full text search engine in Go by Shraal on Friday October 10, 2025 @06:24AM (#45537221)
Time and risk of comments/docs becoming outdated and doing more harm than good.

I'm impartial in this discussion but that's usually how the counter argument goes.

Re:Show HN: I wrote a full text search engine in Go by ok_dad on Saturday October 11, 2025 @05:30PM (#45552876)
The counter argument is bunk, you change the comments when you change the code. It’s not hard. If you forget, them a reviewer will notice. If not, then you aren’t focusing enough attention on the finer details of a project, to your detriment.

Personally, I find that a lot of good, accurate comments and documentation helps me to trust a code base more because I can see that the devs cared and focused on the finer details rather than just tossing code over a fence at me.