-
Notifications
You must be signed in to change notification settings - Fork 263
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 SIP for governance.md #2593
Merged
Merged
Changes from all commits
Commits
Show all changes
4 commits
Select commit
Hold shift + click to select a range
330c762
add SIP for governance.md
michelleN 242a262
require supermajority quorum instead of vote
michelleN 7106a0b
update wording to clarify substantial governance changes require a SIP
michelleN 16ac5c2
collapse update decision making section
michelleN File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,86 @@ | ||
## Overview | ||
|
||
This document describes the governance of the Spin project. | ||
|
||
The Spin project consists of several codebases with different release cycles. These codebases include: | ||
|
||
- Core Spin: | ||
- [Spin](https://github.com/fermyon/spin) | ||
- SDKs: | ||
- [Spin Python SDK](https://github.com/fermyon/spin-python-sdk) | ||
- [Spin JavaScript SDK](https://github.com/fermyon/spin-js-sdk) | ||
- [Spin Rust SDK](https://github.com/fermyon/spin-rust-sdk) | ||
- [Spin .NET SDK](https://github.com/fermyon/spin-dotnet-sdk) | ||
- [Spin Nim SDK](https://github.com/fermyon/spin-nim-sdk) | ||
- Plugins: | ||
- [Spin Plugins Index Repository](https://github.com/fermyon/spin-plugins) | ||
- [Fermyon Platform Plugin](https://github.com/fermyon/platform-plugin) | ||
- [Spin Test Plugin](https://github.com/fermyon/spin-test) | ||
- [Cloud Plugin](https://github.com/fermyon/cloud-plugin) | ||
- [Spin Cloud GPU Plugin](https://github.com/fermyon/spin-cloud-gpu) | ||
- Triggers: | ||
- [Spin Command Trigger](https://github.com/fermyon/spin-trigger-command) | ||
- [Spin SQS Trigger](https://github.com/fermyon/spin-trigger-sqs) | ||
- [Spin Cron Trigger](https://github.com/fermyon/spin-trigger-cron) | ||
|
||
Each repository is subject to the same overall governance model, but has different teams of people (“maintainers”) with permissions and access to the repository. This is meant to increase diversity of maintainers in the Spin project and also increases the velocity of code changes. Major changes and features to the project including additions to the repository list above are to be proposed through the [Spin Improvement Proposal](docs/content/sips/index.md) process. | ||
|
||
## Spin Project Maintainers | ||
|
||
Project maintainers are responsible for activities surrounding the development and release cycle of a specific repository they own. Technical decisions for code resides with the project maintainers, unless there is a decision related to cross maintainer groups that cannot be resolved by those groups. Those cases can be escalated to the Spin Governance Committee (discussed below). | ||
|
||
Project maintainers do not need to be software developers. No explicit role is placed upon them, and they can be anyone appropriate for the work being produced. | ||
|
||
Project maintainers and emeritus maintainers for each project should be outlined in the MAINTAINERS.md file in the corresponding GitHub repository. | ||
|
||
Changes to project maintainers use the following: | ||
|
||
- A project maintainer may step down by emailing the mailing list. When a project maintainer steps down, they become an emeritus maintainer. | ||
- Project maintainers MUST remain active on the project. If they are unresponsive for > 3 months, they will lose project maintainer-ship, unless the remaining project maintainers of the given project and the Spin Governance Committee agree to extend the period to be greater than 3 months. | ||
- New maintainers MUST be nominated by existing maintainers. Maintainers are to discuss and agree in a private setting adding a new maintainer. Once a descision has been made, a maintainer may be added to the project via a pull request to the relevant MAINTAINERS.md file. | ||
- A maintainer may be removed for a [code of conduct](CODE_OF_CONDUCT.md) violation by the Spin Governance Committee. Code of conduct violations may be submitted to any member(s) on the Spin Governance Committee by email. See email information on MAINTAINERS.md. | ||
- When a project has no active maintainers, the maintainers of the [fermyon/spin Github repo](https://github.com/fermyon/spin) become responsible for it, and may archive the project, or find new maintainers | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. end sentence with period |
||
|
||
## Spin Governance Committee | ||
|
||
The project maintainers for [github.com/fermyon/spin](http://github.com/fermyon/spin) also serve as the Spin Governance Committee and have the following additional responsibilities: | ||
|
||
- Maintaining the mission, vision, values, and scope of the project | ||
- Refining this governance document | ||
- Making project level decisions | ||
- Making decisions about project licensing, contribution requirements, and other legal matters | ||
- Resolving escalated project decisions when responsible project maintainers are blocked | ||
- Managing the Spin brand | ||
- Managing access to Spin assets such as source repositories, hosting, project calendars | ||
- Handling code of conduct violations for any repository under the Spin project | ||
- Deciding what sub-groups and repositories are part of the Spin project | ||
- Overseeing the resolution and disclosure of security issues | ||
- Managing financial decisions related to the project | ||
|
||
In addition to the responsibilities listed above, this group is also responsible for bootstrapping a multi-stakeholder steering committee of 5-7 people to govern the project. The group is responsible for creating a steering committee Charter and shaping and executing the processes around selecting committee members. Once a steering committee is in place, the Spin Governance Committee will be dismantled and replaced with the Spin Steering Committee. The Spin Steering Committee should then establish additional governance structures as it sees fit (e.g., a Code of Conduct Committee for project moderation). | ||
|
||
The Spin Governance Committee have to match the following criteria: | ||
|
||
- Spin Governance Committee members MUST remain active on the project. If they are unresponsive for > 3 months, they will lose membership, unless the remaining members of the committee agree to extend the period to be greater than 3 months | ||
|
||
The Spin Governance Committee will select a chair to set agendas, call meetings, and oversee the decision making process. | ||
|
||
## Decision Making | ||
|
||
The default decision making process is objection-free consensus. In other words, a decision is made when all decision makers have had time to consider the decision and do not raise any objections. Silence on any consensus decision is equivalent to non-objection. Explicit agreement may be stated at will. | ||
|
||
Decision making scenarios MUST be promoted appropriately by the maintainer or committee member overseeing the issue. All substantial changes in any part of the Spin project including for governance related changes require a SIP. | ||
|
||
All substantial changes to governance require a supermajority quorum on the governance committee. | ||
|
||
In the extreme case that objection-free consensus cannot be reached after a reasonable amount of time and effort between project maintainers on a project level decision, a project maintainer can call for a [supermajority](https://en.wikipedia.org/wiki/Supermajority#Two-thirds_vote) vote from the project maintainers for a repo on a decision. If quorum cannot be met for a decision, all members of the Spin Governance Committee are added to the relevant vote. | ||
|
||
If a decision impacts multiple repositories or requires a coordinated effort across multiple repositories and project maintainers are unable to reach a decision on their own for the relevant projects, a maintainer can call for a decision from the Spin Governance Committee. | ||
|
||
In the extreme case that objection-free consensus cannot be reached after a reasonable amount of time and effort on the governance committee, a committee member can call for a supermajority vote form the committee. If another member seconds the vote, the vote MUST take place. | ||
|
||
## Glossary | ||
|
||
- Objection-free consensus: A decision is made when all decision makers have had time to consider the decision and do not raise any objections. Silence on any consensus decision is equivalent to non-objection. Explicit agreement may be stated at will. | ||
- Supermajority: Two-thirds majority where at least two-thirds of the group is in favor of the decision being made. More context [here](https://en.wikipedia.org/wiki/Supermajority#Two-thirds_vote). | ||
- Emeritus Maintainer: These are project maintainers that are no longer active. We model this after the Helm Emeritus Maintainer role. More context [here](http://technosophos.com/2018/01/11/introducing-helm-emeritus-core-maintainers.html). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
title = "SIP 019 - Spin Governance" | ||
template = "main" | ||
date = "2024-06-18T23:00:00Z" | ||
|
||
--- | ||
|
||
Summary: Adding governance to the Spin project | ||
|
||
Owner: michelle@fermyon.com | ||
|
||
Created: June 18, 2024 | ||
|
||
## Background | ||
|
||
Spin is a project now used by many organizations and individuals across the software ecosystem. In order for the Spin community to continue to rely on, build on, and integrate with Spin, there should be a public collective understanding of how the Spin project is governed and how to iterate on governance. | ||
|
||
## Proposal | ||
|
||
This SIP is a proposal to add a GOVERNANCE.md file (submitted with this SIP) to the root of the Spin repository. The governance structure described in the governance document file aims to describe transparently a process close to how we've been doing things so far in the project and how to make changes. It formally opens up the project for maintainers from multiple organizations, defines maintainership roles, describes decision making processes and more. | ||
|
||
The structure outlined in the governance document is established as a temporary bootstrapping phase on the road to a more permanent, multi-stakeholder model. The Spin Governance Committee established in the current governance document should eventually be dismantled and replaced with a smaller, more well defined group only tasked with governing the Spin project as a whole (a "Steering Committee"). This group will in turn establish other committees for handling more specific governance concerns (e.g., Project moderation and CoC enforcement). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Typo on decision