618
4 out of 5 developers
(files.techhub.social)
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 24 Sep 2025
618 points (99.5% liked)
Programmer Humor
27963 readers
1273 users here now
Welcome to Programmer Humor!
This is a place where you can post jokes, memes, humor, etc. related to programming!
For sharing awful code theres also Programming Horror.
Rules
- Keep content in english
- No advertisements
- Posts must be related to programming or programmer topics
founded 2 years ago
MODERATORS
Yesterday I got feedback on my PR asking me to add more XML comments. The userId parameter of type Guid parameter didn't have a param tag that said that it was the ID of the user. I was unable to convince them this was unnecessary and eventually conceded by adding a comment userId: ID of user.
See, that to me is an example of a useless comment. The only way I'd justify it is if you have some validation that checks if all public methods have xml comments or something. But userId: ID of user sounds redundant to me.