this post was submitted on 31 Oct 2025
10 points (85.7% liked)

C++

2173 readers
1 users here now

The center for all discussion and news regarding C++.

Rules

founded 2 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
[–] DampCanary@lemmy.world 2 points 1 month ago

After few years in programming I can attest that "Write Self-Documenting Code" doesn't hold. No matter how much coder thinks their code is self explanatory.
An addition of nice, concise, and blunt comment on critical points in function saves heads (and brains) of whoever comes next.
Writing comments is cheaper in long run, than any clever variable/function naming. (note: I'm not saying that names should be abstract, but by them self are not enough to make code user frendly).