this post was submitted on 05 Aug 2023

915 points (96.2% liked)

Programmer Humor

19097 readers

1064 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 1 year ago

MODERATORS

Feyter@programming.dev

Vacant@programming.dev

anzo@programming.dev

BurningTurtle@programming.dev

915

Always write comments (lemmy.world)

submitted 1 year ago by alphacyberranger@lemmy.world to c/programmer_humor@programming.dev

42 comments fedilink hide all child comments

you are viewing a single comment's thread
view the rest of the comments

[–] marty@discuss.tchncs.de 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.