18
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
this post was submitted on 19 Oct 2025
18 points (100.0% liked)
TechTakes
2271 readers
61 users here now
Big brain tech dude got yet another clueless take over at HackerNews etc? Here's the place to vent. Orange site, VC foolishness, all welcome.
This is not debate club. Unless it’s amusing debate.
For actually-good tech, you want our NotAwfulTech community
founded 2 years ago
MODERATORS
Depends on how they are used. They are extremely useful when they add context that is otherwise not present in the code, but way too often I see people simply restating what the code does in the comment. That's not very useful and can become confusing if the code later gets updated without updating the associated comment.
this seems counterintuitive but... comments are the best, name of the function but longer are the worst. Plain text summary of a huge chunk of code that I really should have taken the time to break up instead of writing a novella about it are somewhere in the middle.
I feel a lot of bad comment practices are downstream of javascript relying on jsdoc to act like a real language.