this post was submitted on 08 Jun 2024
717 points (97.0% liked)

Programmer Humor

32042 readers
1375 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
[–] thesporkeffect@lemmy.world 36 points 3 months ago (6 children)

Honestly documentation is at least as important as code , but I get you

[–] OpenStars@discuss.online 21 points 3 months ago (5 children)

And isn't testing even more so!?

img

[–] thesporkeffect@lemmy.world 11 points 3 months ago (2 children)

Agree, I would put tests higher than documentation, I just got to documentation first and was triggered enough to comment immediately

[–] wols@lemm.ee 0 points 3 months ago

Bonus: good tests can also serve as technical documentation.

Though I have to disagree with the notion that documentation is as important or more so than code.
Documentation is certainly near the top of the list and often undervalued. I've worked on a project where documentation was lacking and it was painful to say the least.
Without documentation, changing or adding features can be a nightmare. Investigating bugs and offering support is also very difficult. But without code, you have nothing. No product, no users, no value.

There are (inferior) substitutes for documentation: specialized team knowledge, general technical expertise. These alternative pools of knowledge can be leveraged to create and improve documentation incrementally.
There's no replacement for the actual functionality of your applications.

load more comments (1 replies)
load more comments (3 replies)
load more comments (3 replies)