this post was submitted on 26 Nov 2023
699 points (89.1% liked)
Programmer Humor
19463 readers
152 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
- Keep content in english
- No advertisements
- Posts must be related to programming or programmer topics
founded 1 year ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
Code looks better without comments
Comment only in extraordinary situations, when something you read can confuse someone. And by that I mean the business logic, not that you used a method that's confusing to people since they only know the basics of the language.
Honestly, after a few years of working with juniors (and being one myself before that), I have to disagree with the last part. Sure, it's fine for solo projects but people's programming skills can vary heavily. I know people who will pull the wildest C++ compile time tricks you've ever seen, but a pointer to a pointer would somehow break their brain.
I usually comment on whole groups of lines of code, so the goal of each part of the code is clear
I would disagree. I love to use comments to format my code and separate the sections. I think it's so beautiful. Also I love when libraries have ASCII art in the comments at the top of the main file lol. It makes the code more fun in my opinion.
I went to college with a guy who would treat the code as art when presenting projects. His code was always beautiful. Not super functional but always beautiful. It always stuck with me. I want my code to always be functional and beautiful. Easy to read and a pleasure to work with. That's my goal at least. Comments help with that.
Also it depends on what the code is for haha