this post was submitted on 06 Jul 2024
1535 points (99.4% liked)

Programmer Humor

19587 readers
2075 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 1 year ago
MODERATORS
Feyter@programming.dev
anzo@programming.dev
BurningTurtle@programming.dev
pylapp@programming.dev
1535
How programmers comment their code (lemmy.dbzer0.com)
submitted 4 months ago by Andromxda@lemmy.dbzer0.com to c/programmer_humor@programming.dev
145 comments fedilink hide all child comments
 

https://nitter.poast.org/denicmarko/status/1774077890281267451

you are viewing a single comment's thread
view the rest of the comments
[–] englislanguage@lemmy.sdf.org 1 points 4 months ago

I have worked on larger older projects. The more comments you have, the larger the chance that code and comment diverge. Often, code is being changed/adapted/fixed, but the comments are not. If you read the comments then, your understanding of what the code does or should do gets wrong, leading you on a wrong path. This is why I prefer to have rather less comments. Most of the code is self a explanatory, if you properly name your variables, functions and whatever else you are working with.