Disclaimer

Not trying to blame anyone here. I‘m just taking an idea I‘ve read and spinning it further:

Intro

A lot of people use free open source software (foss), Linux being one of them. But a lot less actually help make this software. If I ask them why, they always say „I don’t have the coding skills!“.

Maybe its worth pointing out that you don‘t need them. In a lot of cases it’s better to not have any so you can see stuff with a „consumer view“.

In that situation you can file issues on github and similar places. You can write descriptions that non technical people can understand. You can help translate and so on, all depending on your skills.

Other reasons?

I‘d really like to know so the foss community can talk about making it worthwile for non coders to participate.

  • Carighan Maconar@lemmy.world
    202·
    6 months ago

    What use is a readme written by someone who doesn’t know the code, doesn’t know the internal designs, the design goals, the plans of the current maintainers, anything? It’d be no better than asking ChatGPT to write it for you.

    • megane-kun@lemm.eeEnglish
      5·
      6 months ago

      Yeah, that’s a good point, but the readmes that I’ve seen written by those who wrote the code themselves are not much better. Sure, they know what it’s all about, which is precisely why it oftentimes isn’t much help for a user.

      What’s needed is someone who’d read the initial readme (written by the guy who wrote the code itself) and ask questions about the parts that were “too straightforward” to be included, or weren’t explained clearly enough, or to bring down the general overview back to Earth.

      And if there’s yet another person who’d go over this second pass, and keep it from being too dumbed down, even better. Keep it to the level of the average user. That requires knowing the kind of person who’d likely use the program.

    • hauiOPA
      61·
      6 months ago

      I‘m sure a lot of people who correct text, add references, structure and pictures to a readme would disagree with you.

      I‘m not sure if you‘re a coder but it you are, you should know that coding and usability are two entirely separate things.

      • Carighan Maconar@lemmy.world
        111·
        6 months ago

        Oh…

        You don’t mean the readme file. You are talking about the manual, or the explanations on the website. Yeah that can make sense. Though I would still say it’s weird if you’re not too familiar with the direction the application is going, but an experienced user can of course help create better texts and pages for that.

    • agent_flounder@lemmy.worldEnglish
      2·
      6 months ago

      Why does it have to be documenting internal designs, architecture, and all that? Why not app user manuals or install guides or any of myriad other sorts of documentation?

      Just because one specific scenario may not be suited doesn’t mean no scenario is suited to what op is proposing.

      I mean first, what kind of projects are we even talking about, libraries? APIs? Apps? Command line tools? Etc?

      Because the technical writing needs vary depending on what kind of project. They don’t all require coding skills for success.