The corporate culture does not allow appropriate time for the documentation as it is considered something that cost money without a quantifiable gain.

It permeates in the FOSS space as well since writing good documentation is a skill and it is not fostered in corporations. So devs start great projects with terrible documentation.

[–] raspberriesareyummy@lemmy.world 15 points 1 day ago (1 children)

One way to contribute to FOSS is to improve bad documentation. You are correct, of course, and lazy devs write bad code if they do not cultivate good documentation - imho.

[–] ryannathans@aussie.zone 1 points 23 hours ago

Then they don't learn the skill for themselves lmao, can't win

[–] ChogChog@lemmy.world 5 points 20 hours ago

Does anyone know of any good resources on writing good documentation? It’s a thing I’m weirdly passionate about and absolutely want to get better at for my own sanity and for others as well if I can contribute.

But it seems like it’s a very under discussed subject..

Veronica Explains has a really good video talking about how much of a dead skill it is now from the standards it used to be.