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
- Respect instance rules.
- Don't be a jerk.
- Please keep all posts related to C++.
founded 2 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
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).