Comment on What self hosting feels like (It's painful, please help 🥲)

• Semi_Hemi_Demigod@lemmy.world ⁨1⁩ ⁨month⁩ ago

  If you know your weakness is writing documentation, please hire a technical writer.

  source

  • HK65@sopuli.xyz ⁨1⁩ ⁨month⁩ ago

    That’s exactly what I’m saying, sorry if it came across somehow askew.

    My point was there is no point in competing over whose job is “better”, we should be working together.

    source

    • vividspecter@lemm.ee ⁨1⁩ ⁨month⁩ ago

      There is a case to be made that people should be a bit more well rounded in general, and not just find a specific niche.

      So non-technical people should still have a decent familiarity with computers and maybe be able to do some very basic coding. And technical people should spend some time working on their written and verbal communication.

      Because in both cases, it makes people more effective in their roles.

      source
  • RobotToaster@mander.xyz ⁨1⁩ ⁨month⁩ ago

    Most open source projects rely on volunteers, and very few technical writers volunteer.

    source

    • Semi_Hemi_Demigod@lemmy.world ⁨1⁩ ⁨month⁩ ago

      Totally agree. And I’d argue that we don’t even need technical writers. Even if all people do is correct grammar and spelling mistakes it would be helpful, let alone actually writing docs. It’s one of the easiest ways non-technical folks can get involved with open source projects.

      source

      • JackbyDev@programming.dev ⁨1⁩ ⁨month⁩ ago

        Every time I get stuck on something confusing I’m a README and figure it out I try to submit a patch that makes it more explicit.

        source
  • GBU_28@lemm.ee ⁨1⁩ ⁨month⁩ ago

    If the documentation is sufficient for the intended audience, it’s good enough.

    source