Skip to content

Commit 3ed7cd5

Browse files
author
Sunil Thaha
authored
Merge pull request #2256 from sunya-ch/nomination-update
chore: add maintainer cycle
2 parents ebd7936 + c80158b commit 3ed7cd5

File tree

1 file changed

+58
-14
lines changed

1 file changed

+58
-14
lines changed

GOVERNANCE.md

Lines changed: 58 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -7,17 +7,18 @@ and are approved through consensus by the existing maintainers.
77

88
### Nomination Protocol
99

10-
#### Submit Nomination
10+
#### Submit Nomination for a New Maintainer or Role
1111

12-
The candidate or an existing maintainer creates
13-
a [maintainer nomination issue](.github/ISSUE_TEMPLATE/maintainer_nominate.yaml)
14-
and submits a pull request (PR) to modify the `MAINTAINERS.md`
15-
or `ADVISORS.md` file to add the nominee.
12+
The candidate or an existing maintainer creates a [maintainer nomination issue](.github/ISSUE_TEMPLATE/maintainer_nominate.yaml) and submits a pull request (PR) to update the `MAINTAINERS.md`
13+
or `ADVISORS.md` file by adding the nominee or reflecting the new role.
1614

1715
#### Voting
1816

19-
The PR requires approval from **at least three maintainers**,
20-
including the nominator if they are not self-nominating.
17+
The PR requires approval from **at least three maintainers**.
18+
19+
For self-nominations, all three approvals must come from other maintainers.
20+
21+
For nominations by existing maintainers, the nominator's approval counts toward the three required.
2122
Maintainers indicate their approval by approving on the PR.
2223

2324
#### Approval and Merge
@@ -28,6 +29,48 @@ If the nominee is not yet added as a maintainer to the repository,
2829
they should be added at this point,
2930
officially confirming their maintainer status.
3031

32+
### Active Maintainer Definition
33+
34+
An **active maintainer** is a contributor who demonstrates ongoing commitment
35+
to the Kepler project through regular participation and meaningful contributions.
36+
Active maintainers are listed in the [`MAINTAINERS.md`](https://github.com/sustainable-computing-io/kepler/blob/main/MAINTAINERS.md)
37+
file to provide users with a reliable point of contact for project-related questions,
38+
support, and collaboration.
39+
40+
Active maintainer will be reviewed on a 6-month cycle.
41+
42+
| **Cycle** | **Active Period** | **Nomination / Review Period** |
43+
|-----------|---------------------------|--------------------------------------|
44+
| **Fall** | October 1 – March 31 | August 1 – September 30 |
45+
| **Spring**| April 1 – September 30 | February 1 – March 31 |
46+
47+
- Active maintainers are expected to maintain engagement during each cycle by providing tangible contributions in accordance with the [Active Engagement Expectations](#active-engagement-expectations).
48+
- A designated person responsible for maintaining the maintainer list will create an issue during each review period to propose changes based on observed activity. This issue will remain open throughout the window, giving maintainers the opportunity to review and confirm their status.
49+
- Maintainers who are not included in the proposed active list may respond or rebut (i.e., provide justification or recent contributions) to remain on the list.
50+
- Maintainers who do not confirm their active status during the review period will be moved to the **Emeritus** list.
51+
- **Emeritus maintainers** can return to active status in a future cycle by reaffirming their commitment to active participation.
52+
53+
This lightweight process helps streamline contributor engagement while maintaining an up-to-date and representative list of active maintainers.
54+
55+
#### Active Engagement Expectations
56+
57+
To help maintain a healthy and transparent governance process, the following example metrics can be used to demonstrate active involvement over a 6-month cycle. These are **guidelines**, not strict requirements:
58+
59+
- Volunteering for specific operational tasks such as:
60+
- Hosting community meetings
61+
- Triage and issue management
62+
- Release coordination or management
63+
- Triage and response to community questions in Slack channels
64+
- Attending **more than 25% of community meetings** (e.g., at least 4 out of 12 calls within a cycle)
65+
- Actively participating in **more than 3 triaged issues** (e.g., raising, commenting on, or resolving issues)
66+
- Completing **more than 3 pull request reviews**
67+
- Actively promoting the Kepler project in the community, such as:
68+
- Organizing a meetup
69+
- Writing a blog post
70+
- Giving a talk or presentation at an event
71+
72+
These metrics support transparency in participation and help ensure that active maintainers remain engaged and accountable to the community.
73+
3174
## Maintainers
3275

3376
Maintainers are responsible for the overall health and progress of the project.
@@ -47,13 +90,13 @@ Their roles and responsibilities are organized into functional areas:
4790

4891
### 2. Technical Committee
4992

50-
- Oversee the overall direction of the Kepler project.
93+
- Oversee the overall direction of the Kepler project
5194
- Provide guidance for the project maintainers and the onboarding process for
52-
new maintainers.
53-
- Actively engage in the technical committee meetings.
95+
new maintainers
96+
- Actively engage in the technical committee meetings
5497
- Participate in design and technical discussions
55-
- Review and approve pull requests,
56-
especially those involving significant technical changes or core areas
98+
- Review and approve pull requests involving significant technical changes,
99+
core architecture decisions, and breaking changes
57100

58101
#### Becoming a Technical Committee Member
59102

@@ -95,7 +138,8 @@ significant contributions including:
95138
- Respond to contributor questions in forums, Slack, GitHub Discussions
96139
- Connect contributors with the appropriate maintainers or domain experts
97140
- Welcome new contributors and guide them toward first issues
98-
- Review and approve pull requests, especially those involving community engagement
141+
- Review and approve pull requests involving documentation,
142+
community resources, and contributor experience improvements
99143

100144
The current list of maintainers is published and updated in
101145
[MAINTAINERS.md](./MAINTAINERS.md).
@@ -129,7 +173,7 @@ The contributor is nominated by opening a PR against the appropriate repository,
129173
which adds their GitHub username to
130174
one or more [OWNERS file](https://www.kubernetes.dev/docs/guide/owners/).
131175

132-
At least one member of the maintainer or the team
176+
At least one member of the maintainers or the team
133177
that owns that repository or main directory,
134178
who are already Approvers, approve the PR.
135179

0 commit comments

Comments
 (0)