Skip to content

Commit ad70a0d

Browse files
committed
Update governance: List of maintainers, new roles, security clarifications
Signed-off-by: Marvin Beckers <[email protected]>
1 parent 384a53c commit ad70a0d

File tree

3 files changed

+75
-9
lines changed

3 files changed

+75
-9
lines changed

GOVERNANCE.md

Lines changed: 37 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ is the governing body for the project.
7070
a Maintainer or Owner, then this section should instead be a reference to that
7171
documentation -->
7272

73-
To become a Maintainer you need to demonstrate the following:
73+
To become a [Maintainer](./MAINTAINERS.md) you need to demonstrate the following:
7474

7575
* commitment to the project:
7676
* participate in discussions, contributions, code and documentation reviews
@@ -119,10 +119,8 @@ and can be rapidly returned to Maintainer status if their availability changes.
119119

120120
Time zones permitting, Maintainers are expected to participate in the public
121121
community call meeting. Maintainers will also have closed meetings in order to
122-
discuss security reports or Code of Conduct violations. Such meetings should be
123-
scheduled by any Maintainer on receipt of a security issue or CoC report.
124-
All current Maintainers must be invited to such closed meetings, except for any
125-
Maintainer who is accused of a CoC violation.
122+
discuss security reports. Such meetings should be scheduled by any Maintainer on
123+
receipt of a security issue. All current Maintainers must be invited to such closed meetings.
126124

127125
## Code of Conduct
128126

@@ -146,19 +144,52 @@ at least once a year.
146144
The Security Response Team is responsible for handling all reports of security
147145
holes and breaches according to the [security policy](./SECURITY.md).
148146

147+
The members of the Security Response Team are documented in [MAINTAINERS.md](./MAINTAINERS.md).
148+
149149
## Voting
150150

151151
While most business in kcp is conducted by "lazy consensus", periodically
152152
the Maintainers may need to vote on specific actions or changes.
153153
A vote can be taken on [the developer mailing list](https://groups.google.com/g/kcp-dev) or
154154
[the private Maintainer mailing list](https://groups.google.com/g/kcp-dev-private)
155-
for security or conduct matters. Votes may also be taken at the community call
155+
for security issues. Votes may also be taken at the community call
156156
meeting. Any Maintainer may demand a vote be taken.
157157

158158
Most votes require a simple majority of all Maintainers to succeed. Maintainers
159159
can be removed by a 2/3 majority vote of all Maintainers, and changes to this
160160
Governance require a 2/3 vote of all Maintainers.
161161

162+
Pull requests that make changes requiring Maintainer consensus may also be
163+
understood as a vote. They require the stated majority to be granted via
164+
LGTMs on the pull request. Such a pull request shall be announced to the developer
165+
mailing list and put on hold until the necessary majority has been reached.
166+
167+
## Subprojects
168+
169+
Any Maintainer may submit a [vote](#voting) to create a new subproject under the
170+
kcp-dev GitHub organization. Subprojects are governed by all Maintainers, but may
171+
take on additional Subproject Maintainers that are only responsible for the
172+
specific subproject.
173+
174+
It is the combined responsibility of Maintainers and Subproject Maintainers
175+
to review contributions to subprojects and make project goal decisions.
176+
Subproject Maintainers are not part of the private Maintainer mailing list and
177+
are involved in security responses on a need-to-know basis if the reported security
178+
issue concerns their respective subproject.
179+
180+
Subproject Maintainers are elected by the Maintainers. Subproject Maintainers are
181+
allowed to participate in votes concerning their respective subprojects.
182+
183+
## Approvers
184+
185+
The Maintainers and Subproject Maintainers may elect trusted contributors to
186+
assist them in the review process for specific parts of the code. Those Approvers
187+
are allowed to approve and merge code contributions for certain subsets of the code
188+
(not a whole project), e.g. areas of the code that they have proven themselves
189+
to be very familiar with.
190+
191+
Approvers do not have voting rights.
192+
162193
## Modifying this Charter
163194

164195
Changes to this Governance and its supporting documents may be approved by a

MAINTAINERS.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# Maintainers
2+
3+
The table below lists all current maintainers for the kcp project as defined by our [project governance](./GOVERNANCE.md).
4+
5+
| Name | GitHub Handle | Domains of reponsibility | Affiliation |
6+
| --------------------- | ------------------------------------------------ | -------------------------------------------------------------- | --------------------------- |
7+
| Andy Anderson | [@clubanderson](https://github.com/clubanderson) | Governance | IBM |
8+
| Sebastian Scheele | [@scheeles](https://github.com/scheeles) | Governance | Kubermatic |
9+
| Dr. Stefan Schimanski | [@sttts](https://github.com/sttts) | Governance, kcp core | NVIDIA |
10+
| Christoph Mewes | [@xrstf](https://github.com/xrstf) | kcp core, API Syncagent kcp-operator, infrastructure | Kubermatic |
11+
| Mangirdas Judeikis | [@mjudeikis](https://github.com/mjudeikis) | kcp core | Upbound |
12+
| Marvin Beckers | [@embik](https://github.com/embik) | kcp core, kcp-operator, multicluster-provider, infrastructure | Kubermatic |
13+
14+
## Emeritus Maintainers
15+
16+
No emeritus maintainers currently exist. We would like to highlight that this project does have prior maintainers and core contributors
17+
that, if they so wished, could (and should) be granted the status of emeritus maintainers.
18+
19+
## Security Response Team
20+
21+
The following maintainers are members of the security response team and enact the [security process](./SECURITY.md):
22+
23+
- Dr. Stefan Schimanski
24+
- Mangirdas Judeikis
25+
- Marvin Beckers

SECURITY.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,22 @@ The kcp maintainers take security for kcp very seriously, especially given kcp's
44

55
## Reporting a Vulnerability
66

7-
kcp uses GitHub to allow submission of private security reports. Please report any security finding via [this link](https://github.com/kcp-dev/kcp/security/advisories/new) or send a direct email to [[email protected]](mailto:[email protected]). Maintainers will triage your report as soon as possible and get in touch with you via your report or via email in case they have more questions.
7+
kcp uses GitHub to allow submission of private security reports. Please report any security finding via
8+
[this link](https://github.com/kcp-dev/kcp/security/advisories/new) or send a direct email to [[email protected]](mailto:[email protected]).
9+
Maintainers will triage your report as soon as possible and get in touch with you via your report or via email in case they have more questions.
810

9-
As a security researcher, please report vulnerabilities to kcp in a [coordinated vulnerability disclosure](https://cheatsheetseries.owasp.org/cheatsheets/Vulnerability_Disclosure_Cheat_Sheet.html) fashion. In return, maintainers pledge to engage in good faith and collaborate with security researchers to address and publish vulnerabilities found in kcp as soon as possible.
11+
As a security researcher, please report vulnerabilities to kcp in a [coordinated vulnerability disclosure](https://cheatsheetseries.owasp.org/cheatsheets/Vulnerability_Disclosure_Cheat_Sheet.html)
12+
fashion. In return, maintainers pledge to engage in good faith and collaborate with security researchers to address and publish vulnerabilities found in kcp as soon as possible.
1013

1114
Please understand that the maintainers also do not accept results of dependency scanners without proof that the detected CVE / vulnerability can be used against kcp.
1215

1316
## Security Advisories
1417

15-
Advisories are managed through GitHub. Public disclosure of vulnerabilities happens through GitHub and the kcp-users mailing list. Please visit [Security Advisories](https://github.com/kcp-dev/kcp/security/advisories) to review security bulletins published by the maintainers.
18+
Advisories are managed through GitHub. Public disclosure of vulnerabilities happens through GitHub and the kcp-users mailing list.
19+
Please visit [Security Advisories](https://github.com/kcp-dev/kcp/security/advisories) to review security bulletins published by the maintainers.
20+
21+
## Security Response Committee
22+
23+
kcp maintainers have formed a security response committee to ensure that security reports get addressed in a timely manner.
24+
You can find the list of members in [MAINTAINERS.md](./MAINTAINERS.md). Please do not contact them directly but follow the
25+
vulnerability reporting process as described abvove.

0 commit comments

Comments
 (0)