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

Programmer Humor

32259 readers
168 users here now

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

Rules:

founded 5 years ago
MODERATORS
 
(page 2) 47 comments
sorted by: hot top controversial new old
[–] [email protected] 2 points 2 weeks ago

It should have the numbers change in the middle like a digital clock but look like the numbers on a clock.

[–] [email protected] 2 points 2 weeks ago (1 children)

@Vordimous Wait for daylight saving time...

[–] [email protected] 1 points 2 weeks ago

Is that when all of the devs write the comments on the line after the code?

[–] [email protected] 2 points 2 weeks ago

When you ask a Dev to test their own code

[–] [email protected] 2 points 2 weeks ago

someone else's code would have the wrong values.

[–] [email protected] 1 points 1 week ago

@Vordimous @linuxgal when I see this sort of thing when reviewing PRs, I write words to the effect of "tell me WHY it's doing that, not WHAT it's doing". The "what" is usually obvious from the code and thus not worthy of comment. The "why" will enlighten your colleagues (and future you).

[–] [email protected] 0 points 2 weeks ago (3 children)

Is this clock wrong half the time or am I just dumb?

[–] [email protected] 2 points 2 weeks ago (1 children)

what times do you think might be wrong?

[–] [email protected] 3 points 2 weeks ago

Nope, I'm just dumb after looking again. 🤣

load more comments (2 replies)
[–] [email protected] 0 points 2 weeks 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!

[–] [email protected] 1 points 2 weeks 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

[–] [email protected] 2 points 2 weeks ago

Gotta get a 4k monitor

load more comments
view more: ‹ prev next ›