Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add GOVERNANCE.md as default community health file #24939

Merged
merged 2 commits into from Apr 28, 2023

Conversation

ShaneCurcuru
Copy link
Contributor

There is a lot of work around sustainability these days, and one key need for open source participants and users is understanding how the many FOSS components they use are governed. Adopting this common file name (already in use in some places) as one of the default community health files can help encourage new projects and organizations to think about governance up front, rather than tacking it on later if they get popular.

Some examples of research and practical work in this space: https://fossgovernance.org/
https://ospo.zone/ggi/
https://github.com/github/MVG
https://sustainoss.org/working-groups/governance-guidance/

Why:

Closes:

What's being changed (if available, include any code snippets, screenshots, or gifs):

Check off the following:

  • I have reviewed my changes in staging (look for the "Automatically generated comment" and click the links in the "Preview" column to view your latest changes).
  • For content changes, I have completed the self-review checklist.

There is a lot of work around sustainability these days, and one key need for open source participants and users is understanding how the many FOSS components they use are governed.  Adopting this common file name (already in use in some places) as one of the default community health files can help encourage new projects and organizations to think about governance up front, rather than tacking it on later if they get popular.

Some examples of research and practical work in this space:
https://fossgovernance.org/
https://ospo.zone/ggi/
https://github.com/github/MVG
https://sustainoss.org/working-groups/governance-guidance/
@welcome
Copy link

welcome bot commented Apr 7, 2023

Thanks for opening this pull request! A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

@github-actions github-actions bot added the triage Do not begin working on this issue until triaged by the team label Apr 7, 2023
@github-actions
Copy link
Contributor

github-actions bot commented Apr 7, 2023

Automatically generated comment ℹ️

This comment is automatically generated and will be overwritten every time changes are committed to this branch.

The table contains an overview of files in the content directory that have been changed in this pull request. It's provided to make it easy to review your changes on the staging site. Please note that changes to the data directory will not show up in this table.


Content directory changes

You may find it useful to copy this table into the pull request summary. There you can edit it to share links to important articles or changes and to give a high-level overview of how the changes in your pull request support the overall goals of the pull request.

Source Preview Production What Changed
communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file.md fpt
ghec
ghes@ 3.8 3.7 3.6 3.5 3.4
fpt
ghec
ghes@ 3.8 3.7 3.6 3.5 3.4

fpt: Free, Pro, Team
ghec: GitHub Enterprise Cloud
ghes: GitHub Enterprise Server
ghae: GitHub AE

@steveward steveward added contributing docs Content related to our contributing docs communities Content related to Communities content This issue or pull request belongs to the Docs Content team waiting for review Issue/PR is waiting for a writer's review and removed triage Do not begin working on this issue until triaged by the team contributing docs Content related to our contributing docs labels Apr 14, 2023
@steveward
Copy link
Member

Thanks for the PR @ShaneCurcuru, I'll get this triaged for review! ✨

Copy link
Contributor

@skedwards88 skedwards88 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for adding this! I made a change to make the example a little more general while still capturing what the governance file might include. I'll get this merged down for you.

@skedwards88 skedwards88 added the ready to merge This pull request is ready to merge label Apr 28, 2023
@docubot docubot added this to Triage in Docs open source board Apr 28, 2023
@skedwards88 skedwards88 added this pull request to the merge queue Apr 28, 2023
Merged via the queue into github:main with commit 0e77125 Apr 28, 2023
31 checks passed
Docs open source board automation moved this from Triage to Done Apr 28, 2023
@github-actions
Copy link
Contributor

Thanks very much for contributing! Your pull request has been merged 🎉 You should see your changes appear on the site in approximately 24 hours. If you're looking for your next contribution, check out our help wanted issues

@RichardLitt
Copy link

Great job, @ShaneCurcuru!

@abbycabs
Copy link
Member

love this! Thanks @ShaneCurcuru & @skedwards88

@ShaneCurcuru ShaneCurcuru deleted the patch-1 branch May 18, 2023 16:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
communities Content related to Communities content This issue or pull request belongs to the Docs Content team ready to merge This pull request is ready to merge waiting for review Issue/PR is waiting for a writer's review
Development

Successfully merging this pull request may close these issues.

None yet

5 participants