• Croquette@sh.itjust.works
    link
    fedilink
    arrow-up
    21
    ·
    5 days 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
      link
      fedilink
      arrow-up
      6
      ·
      5 days 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.