this post was submitted on 05 Aug 2023
897 points (96.3% liked)

Programmer Humor

19817 readers
676 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

founded 2 years ago
MODERATORS
 
you are viewing a single comment's thread
view the rest of the comments
[–] [email protected] 4 points 1 year ago

This is the way. In 'some' cases comments are perfectly fine. Like when you need to document 'why' something was done the way it was our to link to a specific piece of documentation.

When you start commenting 'what' the code does, you code is not self explanatory enough. And those comments will get outdated and need refactoring too. Just more unnecessary work.