this post was submitted on 28 Sep 2024
1165 points (99.0% liked)

Programmer Humor

32561 readers
351 users here now

Post funny things about programming here! (Or just rant about your favourite programming language.)

Rules:

founded 5 years ago
MODERATORS
 
you are viewing a single comment's thread
view the rest of the comments
[–] sjh@sh.itjust.works 0 points 1 month ago (1 children)

Commenting code is a super important habit to get into—it not only helps others understand your thought process but also makes it easier for you to pick up where you left off if you revisit the code later. Plus, well-commented code can significantly reduce the onboarding time for new developers on a project. Remember, comments should explain the "why" behind the code, not just the "what." For instance, stating why you chose a particular algorithm or data structure can be far more helpful than just labeling it. According to a study by SmartBear, 44% of developers regard poorly documented code as a top cause of project delays, so it’s definitely worth the extra effort!

[–] doktormerlin 1 points 1 month ago (1 children)

But it's also important to learn that comments should be brief and concise. We have one file from an ex-dev in which there are 750 lines of code and 2000 lines of comment, when someone wants to maintain this code they always have a hard time because this many comments are taking up so much screen real estate that you can't find the code that actually does stuff

[–] shasta@lemm.ee 2 points 1 month ago (1 children)
[–] ZILtoid1991@lemmy.world 1 points 1 month ago

I only have a 3k monitor, and I can manage it. Sometimes I comment line-by-line even.