🚀 Feature: Add an "explainer" page for why contributing to open source benefits a company

OpenContributionsProject / opencontributionssite

A resource to help advocate for and explain corporate contributions to open source.

https://www.opencontributions.dev

MIT License

23 stars 10 forks source link

🚀 Feature: Add an "explainer" page for why contributing to open source benefits a company #23

Open JoshuaKGoldberg opened 1 year ago

JoshuaKGoldberg commented 1 year ago

Bug Report Checklist

[X] I have tried restarting my IDE and the issue persists.
[X] I have pulled the latest main branch of the repository.
[X] I have searched for related issues and found none that matched my issue.

Overview

Let's add a page to help folks who want to convince their company to contribute to open source! This page should explain:

How contributing to open source benefits a company directly
- Directly improving used dependencies
- It's a good look for recruiting & retention
- Getting company name on project sponsor list
Why contributing to open source is good for the industry as a whole

Additional Info

Per #20, we'll eventually have a full design for the site & menus. But for now this page can live on its own.

This site is built on Next.js. You can create a new page by adding a .md file under src/pages. See https://nextjs.org/docs/basic-features/pages.

Corresponding guide page: #52

seunbayo commented 1 year ago

.take

github-actions[bot] commented 1 year ago

Thanks for taking this issue! Let us know if you have any questions!

seunbayo commented 1 year ago

@JoshuaKGoldberg I think all the explainers should be in an explainer folder like guides instead of having different and separate pages...

What do you think?

JoshuaKGoldberg commented 1 year ago

Sorry, I don't follow - do you mean there should be an explainers/ folder? Or that they should be grouped in the guides/ folder?

My understanding right now is that the going proposal is for something like:

src/
  explainers/
    file
  guides/
    file

seunbayo commented 1 year ago

I meant src/ explainers/ contributingtoopen.md emiand/md guides/ ctos.md

blackgirlbytes commented 1 year ago

@seunbayo good point, buuuuut changing the structure seems out of scope for now, especially since we just got a PR that slightly changes the structure. Instead, let's focus on this issue and we can revisit later! Is that okay?

seunbayo commented 1 year ago

okay, i will wait til that PR is merged so i can pull to see the updates

blackgirlbytes commented 1 year ago

How's it going with the explainer page on why contributing to open source benefits a company? @seunbayo The PR was merged, but it's a separate issue from this folder structure issue, and it's still possible to move forward with this issue.

Let me know if you need help!