Comment on How can i teach myself to contribute to these projects?
slazer2au@lemmy.world 2 weeks ago
Nor 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.
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.
Sounds like you gave yourself a hobby there mate.
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 😂
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.
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 2 weeks 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 2 weeks 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.