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?!
[ Parent
| on HN ]
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.