you are viewing a single comment's thread
view the rest of the comments
[–] 24 points 1 year ago (3 children)

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.

  • source
  • hideshow 3 child comments
  • [–] 7 points 1 year 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.

  • source
  • parent