this post was submitted on 04 Mar 2025
1103 points (99.4% liked)

Technology

63897 readers
5539 users here now

This is a most excellent place for technology news and articles.


Our Rules


  1. Follow the lemmy.world rules.
  2. Only tech related content.
  3. Be excellent to each other!
  4. Mod approved content bots can post up to 10 articles per day.
  5. Threads asking for personal tech support may be deleted.
  6. Politics threads may be removed.
  7. No memes allowed as posts, OK to post as comments.
  8. Only approved bots from the list below, to ask if your bot can be added please contact us.
  9. Check for duplicates before posting, duplicates may be removed
  10. Accounts 7 days and younger will have their posts automatically removed.

Approved Bots


founded 2 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
[–] sugar_in_your_tea@sh.itjust.works 1 points 5 hours ago (1 children)

Thanks for the video, it was great!

What frustrated me, though, was that she joined Bevy by keeping at it and going out of her way to prove her worth (i.e. the way devs get into projects), but then suggests devs go out of their way instead to attract project managers (and designers, presumably). That's not very fun to hear, but I guess that's the way it is.

there is a link to “GitHub” in the contact information.

There's also a link to Matrix, which I'm guessing is the preferred way to jump in and ask questions about how to contribute.

In general, I recommend coming with the intention of being assigned work ("I'm a UX designer and I'd love to help mock up stuff"), but also with ideas on how to improve what's there (e.g. "I found frustrating and would love to show some mockups on how to improve it"). That's the ideal scenario IMO, because it offers to reduce work of existing maintainers without asking for anything in return.

However, that's apparently not happening.

Where’s the contributing guidelines for non-developers?

Where would you naturally look for this? With developers it's easy, you look for "CONTRIBUTING.md" or similar in the repo, as well as hints from templates in issues and PRs. Some will have extensive style guides and whatnot, but most are pretty bare bones.

Should this go on the main website? Somewhere at the start of the technical docs? In the repo in a special place linked from the root?

What about tooling? Should projects set up something like penpot (found after a search for FOSS Figma)? Or are designers okay with images on a wiki or something? Is it reasonable to ask them to submit a GitHub issue and engage that way (they could link to something else)?

I'm genuinely interested here because I'm hopefully going to launch a FOSS project this year, and I would like to facilitate that type of discussion, I just don't know how to do that effectively. To me, linking a chat and the repo is enough, but maybe it's not.

[–] SorteKanin@feddit.dk 1 points 14 minutes ago

There’s also a link to Matrix, which I’m guessing is the preferred way to jump in and ask questions about how to contribute.

Yes but asking directly instead of consuming already-written guidelines is a much higher psychological hill to climb and doesn't feel welcoming. You need to be very passionate to go to Matrix. Also, frankly speaking, UX people are very unlikely to have a user on Matrix or even know what it is or how it works. Developers on the other hand can easily figure this out. You need to be mindful of tech literacy when you're trying to cater to UX people - they won't know anything about Matrix probably.

In general, I recommend coming with the intention of being assigned work

I don't think that's bad, but for developers this is very easy with all the guidelines and the "good first issues" and all that. For UX people, none of these resources exist.

Where would you naturally look for this? With developers it’s easy, you look for “CONTRIBUTING.md” or similar in the repo, as well as hints from templates in issues and PRs. Some will have extensive style guides and whatnot, but most are pretty bare bones.

Should this go on the main website? Somewhere at the start of the technical docs? In the repo in a special place linked from the root?

At the very least this could be in the contributing guidelines on GitHub, but I think having it on the main website (a place much more familiar and friendly to non-technical people) is much better.

What about tooling? Should projects set up something like penpot (found after a search for FOSS Figma)? Or are designers okay with images on a wiki or something? Is it reasonable to ask them to submit a GitHub issue and engage that way (they could link to something else)?

I don't know, I'm not a UX person. Ask them when they arrive. But I would think they can probably figure out to interact on GitHub issues if directed to do so. Developers intuitively know "Oh I want to contribute so I'll need a GitHub account and then need to go look at issues" but UX people don't know this.

To me, linking a chat and the repo is enough, but maybe it’s not.

I definitely don't think that's enough - UX people probably don't even know what a "repo" is.