I use open source self hosted software everyday. I love the community and I would love to be able to contribute to some of these projects.

As far as code goes, I basically no nothing about how it works. I see the development section of the repos I use and again, I’ve go no idea how it works.

How can I teach myself how to offer small improvements to the projects I use?

  • slazer2au@lemmy.world
    link
    fedilink
    English
    arrow-up
    77
    ·
    edit-2
    24 hours ago

    Not all support of oss is code related. Updating documentation is a really important part too but programmers are generally bad at it.
    Translating documentation to other languages too.

    • sem@piefed.blahaj.zone
      link
      fedilink
      English
      arrow-up
      2
      ·
      8 hours ago

      Do you know any open source efforts who will train you how to write documentation in exchange for committing to volunteerimg a certain amount? I would be interested.

    • VonReposti@feddit.dk
      link
      fedilink
      English
      arrow-up
      17
      ·
      21 hours ago

      For a project I liked I saw that the translation of the UI was only about 1% complete for my native language. I decided to dedicate the weekend to get it above 95%. This was apparently the part that seemed too hard for most to make a dent in, but across several new versions my language is still 100%. I think my groundwork made it easier for some sporadic contributors to get a small bit of dopamine when updating the few new strings in a release to see it hit 100% again.

      • manxu@piefed.social
        link
        fedilink
        English
        arrow-up
        5
        ·
        16 hours ago

        You are the hero your community needed! It makes a huge difference for a lot of people when they can read a screen without having to guess what the English words mean.

    • Carl Newton@feddit.uk
      link
      fedilink
      English
      arrow-up
      2
      ·
      15 hours ago

      Translating documentation

      And translations for the application itself in some cases, so that it can be ran and used in different languages. Human contributions to the language files of the application is what my project needs more than anything else, and if you do speak a non-English language fluently, I’d be very grateful! Here’s how I’ve worded it for my project:

      If you would like your language to be supported, please create a new pull request, or a new issue with your language file, using an existing language file as a template.

    • JustEnoughDucks@slrpnk.net
      link
      fedilink
      English
      arrow-up
      5
      ·
      19 hours ago

      Please dear god let STM or Nordic someone hire some technical writers for Zephyr, not just Nordic documentation.

      The data structures, macro basics, and core concepts are OK, but for example ADCs have literally 0 documentation at all, documentation about DMAs is barebones at absolute best, non-led PWMs is not good, etc…

      Pretty much every single peripheral needs 5x-100x the documentation it currently has lol.

        • JustEnoughDucks@slrpnk.net
          link
          fedilink
          English
          arrow-up
          3
          ·
          19 hours ago

          I am already trying to understand all of it first myself. In the middle of a full-strip renovation; I don’t think I will have time to spend on it 😂