this post was submitted on 22 Aug 2023
578 points (99.0% liked)
Open Source
31184 readers
139 users here now
All about open source! Feel free to ask questions, and share news, and interesting stuff!
Useful Links
- Open Source Initiative
- Free Software Foundation
- Electronic Frontier Foundation
- Software Freedom Conservancy
- It's FOSS
- Android FOSS Apps Megathread
Rules
- Posts must be relevant to the open source ideology
- No NSFW content
- No hate speech, bigotry, etc
Related Communities
- !libre_culture@lemmy.ml
- !libre_software@lemmy.ml
- !libre_hardware@lemmy.ml
- !linux@lemmy.ml
- !technology@lemmy.ml
Community icon from opensource.org, but we are not affiliated with them.
founded 5 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
Bug reporting and doco are both very useful, and mostly don't require coding ability. If you find a bug, report it. Use as much detail as you can, ideally with instructions to replicate the bug. "XYZ doesn't work" is useless, "XYZ will crash when used with a invalid file, file to replicate is attached" is gold. Working out exactly what detail is an art, but the more detail you give the Dev, the more chance they have to solve it quickly and easily.
If you struggled to set something up and the documentation wasn't clear, update it. Devs are notoriously bad at writing docs, and most will accept doco PR. (I repeatedly walk people through the setup of my project, because the docs are out of date and I'm too lazy/busy to update them. If someone does this for you, write it down, and see if you can insert it into their docs for them). Anything you do to help new users (which saves the Dev time), is a net positive.
Lastly, coding may seem daunting, but there are tons of resources, and many (but not all) Devs are happy to advise/mentor. Adding small features (button to do X) may be very easy. Some Devs will happily walk you through it if you ask (some may not, depends on the Dev).
https://www.browserstack.com/guide/how-to-write-a-bug-report
https://www.writethedocs.org/guide/writing/beginners-guide-to-docs/
Thank you! This really does point me in the right direction.
And as an aside, I absolutely love how welcoming the open source community is.