this post was submitted on 06 Jul 2024
23 points (96.0% liked)

Programmer Humor

32918 readers
630 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 3 years ago
MODERATORS
Feyter@programming.dev
anzo@programming.dev
BurningTurtle@programming.dev
pylapp@programming.dev
23
How programmers comment their code (lemmy.dbzer0.com)
submitted 2 years ago by Andromxda@lemmy.dbzer0.com to c/programmer_humor@programming.dev
25 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
[–] mundane@feddit.nu 1 points 2 years ago (2 children)

Comments should explain "why", the code already explains "what".

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

Inline comments yes.

Function/Class/Module doc comments should absolutely explain "what".

[–] mundane@feddit.nu 0 points 2 years ago

You are absolutely right. It was inline comments I had in mind.