this post was submitted on 17 Jan 2025
327 points (97.1% liked)

Programmer Humor

20002 readers
1888 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
[–] Alexstarfire@lemmy.world 14 points 14 hours ago (2 children)

This just tells me you don't document well enough.

[–] muntedcrocodile@lemm.ee 17 points 13 hours ago (1 children)

The code is the documentation.

[–] Threeme2189@sh.itjust.works 12 points 12 hours ago (1 children)

Anybody that thinks this is always the case deserves a slow, painful and poorly documented death.

[–] Alexstarfire@lemmy.world 3 points 4 hours ago

Obit: "His life was his obit."

[–] Neptr@lemmy.blahaj.zone 1 points 7 hours ago

Legit. Even if documentation can be time-consuming, it is such a lifesaver and makes the whole process of coding much smoother. It means not as much time wasted backtracking. If you think there is any part of your code you won't understand when you coming back to it, document, document, document.

Sometimes I write some multiline psuedocode comments or/and an explaination of specific choices, especially those invisible choices you make while debugging that aren't apparent when your just reading through your code.

Good thing to do is make code that is generally readable too lol.