this post was submitted on 13 Nov 2025
1013 points (99.2% liked)

Programmer Humor

27322 readers
800 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

founded 2 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
[–] mad_lentil@lemmy.ca 3 points 1 day ago

The fact that documentation and comments can't "fail" if the underlying code changes is a real problem. I've even worked at places which dictated that comments had to go directly above or even beside (inline) with the code they were explaining, so they would show up in any patches changing the code.

What do you think happened? Yup, people would change code and leave the outdated (and wrong) comment untouched, directly to the right of the code they just changed.

Hell, I was one of those people, so I get how it can happen.