431

submitted 6 months ago by orhtej2@eviltoast.org to c/programmer_humor@programming.dev

51 comments fedilink hide all child comments

you are viewing a single comment's thread
view the rest of the comments

[-] Croquette@sh.itjust.works 15 points 6 months ago

The documentation is usually dog shit.

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.

[-] ChogChog@lemmy.world 7 points 6 months 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.