You are viewing a single thread.
View all comments View context
1 point

Yeah, but unironic…

If your code needs comments, it’s either because it’s unnecessarily complex/convoluted, or because there’s more thought in it (e.g. complex mathematic operations, or edge-cases etc.). Comments just often don’t age well IME, and when people are “forced” to read the (hopefully readable) code, they will more likely understand what is really happening, and the relevant design decisions.

Good video I really recommend: https://www.youtube.com/watch?v=Bf7vDBBOBUA

permalink
report
parent
reply
1 point

Yeah, another way I’ve heard it phrased is comments are for explaining why you did things a certain way, not for explaining what it’s doing.

permalink
report
parent
reply
0 points
*

and if you need an unnecessarily complex code for performance sake?

permalink
report
parent
reply
0 points

There’s a comment for you to explain the why.

Rule of thumb: code explains the how and what, comments explain the why.

permalink
report
parent
reply

Programmer Humor

!programmer_humor@programming.dev

Create post

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

Community stats

  • 2.2K

    Monthly active users

  • 862

    Posts

  • 14K

    Comments