this post was submitted on 23 Sep 2023
23 points (87.1% liked)

Programming

17313 readers
241 users here now

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Rules

  • Follow the programming.dev instance rules
  • Keep content related to programming in some way
  • If you're posting long videos try to add in some form of tldr for those who don't want to watch videos

Wormhole

Follow the wormhole through a path of communities [email protected]



founded 1 year ago
MODERATORS
 

A lot of developers are helping the community by making their source code public or publishing packages to npm or something like that. Are there other ways to help? Like helping to find a bug, discussing about how to setup an application for a certain use case or anything like that? Answering questions on Stack overflow is an example but is that the best way?

top 8 comments
sorted by: hot top controversial new old
[–] [email protected] 13 points 1 year ago (1 children)

Something a lot of open source projects lack are designers and UX experts. Translation is also something a lot of people can help with. Documentation writing too.

For the programming community at large, sharing knowledge is a great thing to do. There are many channels available, blogs, wikis, even videos on YouTube.

[–] figurys 1 points 1 year ago

Unfortunately I'm not a UI designer or UX expert:/ Blogs/wiki is an idea but then you would need ideas what to write about. In my dayjob I quite like helping coworkers with a specific problem to figure out what's the problem or what the best solution would be. I'm not sure how I can convert that to helping the community then

[–] [email protected] 11 points 1 year ago (1 children)

Documentation is a big thing that's unfortunately often overlooked. It's not as sexy as adding new features or fixing elusive bugs, but it can really make or break a project for others to use.

[–] [email protected] 7 points 1 year ago (1 children)

And not even documentation, even just adding examples without explaining anything can be so incredibly helpful.

There's a whole bundle of tools that will never be used because its too difficult to figure out how to use them.

[–] [email protected] 2 points 1 year ago

Yes, folks, whenever you see a problem or get confused by something submit a fix for it! I've submitted a PR for a Vim plugin that mentioned some weird Vin task that I added the command to do the thing mentioned. My reasoning was that not everyone knows what that meant. They accepted. I hope it has helped more novice Vim users (like myself) once it was accepted.

[–] PriorProject 5 points 1 year ago

Like helping to find a bug, discussing about how to setup an application for a certain use case or anything like that? Answering questions on Stack overflow is an example but is that the best way?

Generally the best way to help out is to do a thing that's needed and that you can figure out how to do. Your list includes a bunch of good options, and I've been thanked for doing all those things at one point or another. Some common growth paths include:

  1. Using the software
  2. Encountering bugs, problems, or small opportunities for improvement.
  3. Discussing those informally in forums and helping people find workarounds.
  4. Identifying some of those issues as common things other things experience as well, so filing bugs for them with clear explanations and links to related forum discussions.
  5. Reading source code to better understand bugs.
  6. Discussing potential fixes in developer bug threads (or in GitHub or whatever).
  7. Submitting small fixes for simple bugs as pull requests.

Another path might be:

  1. Using the software and reading forums/docs for help.
  2. Answering basic questions on forums, looking to old threads and relevant docs.
  3. Learning about common questions.
  4. Writing blogs or forum posts about common questions.
  5. Submitting improvements to official docs to clarify common areas of confusion.

There are other paths as well, the main thing is to use a thing so you learn about it and then use that knowledge to make it a little easier for the next person. Good luck!

[–] [email protected] 3 points 1 year ago

The "best way" depends on the project and its need, or immediate most pressing needs. You may refer to their contrib docs or ask.

But generally, any quantity and quality contribution helps. Community support and issue reproducibility and testing being low-barrier entry ones. Next lowest barriers being translation and documentation.

[–] [email protected] 3 points 1 year ago

Which community? This is an extremely abstract and large scale question as asked lol.

I think a good way to help the open source community is to fix bugs you find in software and documentation you use that you're capable of fixing. Open source work is extremely easy to get burnt out on. A pull request with a fix for a well documented problem is infinitely better than just a bug report of a well documented problem (which itself is infinitely better than a badly documented bug report).