Skip to content

Conversation

@leandrumartin
Copy link
Collaborator

@leandrumartin leandrumartin commented Oct 27, 2025

I felt there was some difficulty in locating the link to the Slack workspace. This PR attempts to improve the visibility of the link, in part by adjusting some navigational elements to make it clearer which pages are intended to provide resources for incoming contributors and which are for other purposes.

When I initially was looking for the link, I saw the sidebar had a link under "Connect with OSS > Get involved as an individual" labeled "Participate," and another labeled "Contribute." I got confused when "Participate" did not have a link listed there and was instead a directory to other pages, as the name and placement within the sidebar made it seem like it would have the same function as the "Contribute" link. So, in this PR I have moved it in the sidebar view to make its purpose as a directory to other subpages clearer. Other links in the sidebar are structured the same (as directories to other pages), so to keep the structure consistent I rearranged those in the sidebar as well.

With this I think I have addressed most of what caused my confusion in finding the link--I also acknowledge that I was navigating the interface with a different purpose from what a contributor would usually have, in that I was looking for a very specific link and not trying to find general information on how to participate. So I wasn't reading the paragraphs very thoroughly; I think the text on the pages makes the navigation make more sense when I read them from that angle.

However, should there also be added buttons or links elsewhere in the interface? I'm not sure it's fully necessary, but I can add something in if need be.

Since `connect_with/participants` is a directory linking to other pages, it makes sense for the pages it links to to be children under it in the sidebar structure. This was part of the confusion I initially experienced when trying to find the Slack link, as I didn't know whether it would be under "Participate" or "Contribute."
@kungfuchicken
Copy link
Collaborator

I like where this is going. Do you have the bandwidth to also create a React Component that is more visibly prominent, like a big button with a Slack logo and "Join Slack" or something similar that we can put in the header and pepper throughout pages?

@leandrumartin
Copy link
Collaborator Author

Yes, I can. However it seems like it would be hard to test at the moment as I'm running into trouble with npm install. As far as I can tell it's because of outdated/deprecated dependencies. I can work on this in another branch.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants