this post was submitted on 01 Sep 2023
323 points (96.5% liked)

Programming

22019 readers
300 users here now

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Rules

  • Follow the programming.dev instance rules
  • Keep content related to programming in some way
  • If you're posting long videos try to add in some form of tldr for those who don't want to watch videos

Wormhole

Follow the wormhole through a path of communities !webdev@programming.dev



founded 2 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
[–] AdmiralShat@programming.dev 94 points 2 years ago* (last edited 2 years ago) (21 children)

If you don't add comments, even rudimentary ones, or you don't use a naming convention that accurately describes the variables or the functions, you're a bad programmer. It doesn't matter if you know what it does now, just wait until you need to know what it does in 6 months and you have to stop what you're doing an decipher it.

[–] A_Porcupine@lemmy.world 34 points 2 years ago (1 children)

However, engineers who rely solely on comments to explain their code, are bad at writing readable code.

[–] RobMyBot@lemmy.ml 2 points 2 years ago

Possibly, but I'd prefer this scenario over the other.

load more comments (19 replies)