From 240e512f0e5d081c82c8d124164d6f84c20fd683 Mon Sep 17 00:00:00 2001 From: Jennifer Power Date: Fri, 6 Sep 2024 16:19:38 -0400 Subject: [PATCH] feat: add a GitVote profiles and instructions Signed-off-by: Jennifer Power --- .gitvote.yml | 17 +++++++++++++++++ GOVERNANCE.md | 24 +++++++++++++++++++----- 2 files changed, 36 insertions(+), 5 deletions(-) create mode 100644 .gitvote.yml diff --git a/.gitvote.yml b/.gitvote.yml new file mode 100644 index 0000000..59b66f5 --- /dev/null +++ b/.gitvote.yml @@ -0,0 +1,17 @@ +profiles: + default: + duration: 4w + pass_threshold: 51 + periodic_status_check: "2 weeks" + close_on_passing: true + allowed_voters: + teams: + - oversight-committee-members + super: + duration: 4w + pass_threshold: 66 + periodic_status_check: "2 weeks" + close_on_passing: true + allowed_voters: + teams: + - oversight-committee-members \ No newline at end of file diff --git a/GOVERNANCE.md b/GOVERNANCE.md index b931576..32e1d76 100644 --- a/GOVERNANCE.md +++ b/GOVERNANCE.md @@ -72,15 +72,29 @@ In the event that consensus cannot be reached, a Maintainer can call for a vote ### Explicit Voting -The secondary decision-making process is done by explicit voting. +The secondary decision-making process is done by explicit voting. -#### Simple Majority Vote +#### Process -If a vote is called, the default is a simple majority vote - more than half of the appropriate deciding body. +We use the [GitVote](https://github.com/cncf/gitvote) bot to streamline our voting efforts. -#### Supermajority Vote +- Organization-level voting must take place in the community (this repository) repository. +- Only GitHub Issues and Pull Requests are supported. -In some cases, a supermajority vote is required for decision making - at least two-thirds of the appropriate deciding body. +The GitVote [repository](https://github.com/cncf/gitvote/blob/main/README.md) has additional information on usage. + +There are some constant configurations between voting profiles: + +- The Oversight Committee members have binding votes in the community repository. All in the community can and are encouraged to participate in the vote, even if their vote is not binding. +- The duration for voting is four weeks with status checks occurring at the two week mark. + +##### Simple Majority Vote + +If a vote is called, the default is a simple majority vote - more than half of the appropriate deciding body. This is the default profile used when calling a vote with `/vote` + +##### Supermajority Vote + +In some cases, a supermajority vote is required for decision making - at least two-thirds of the appropriate deciding body. You can use `/vote-super` to initiate this type of vote. Some examples include: