Skip to content

Commit 6c5fe7a

Browse files
authored
Update GOVERNANCE.md
Matt I tried two things one making the main headers a bit bigger and also adding some more separation lines. I am thinking that with them being bigger we maybe don't need the lines.
1 parent 5d4656b commit 6c5fe7a

File tree

1 file changed

+16
-8
lines changed

1 file changed

+16
-8
lines changed

GOVERNANCE.md

+16-8
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,11 @@
1414
* [Updates to this Document](#updates-to-this-document)
1515
* [Contact](#contact)
1616

17-
## Podman Project
17+
# Podman Project
1818

1919
This document defines the governance of the Podman Project, including its subprojects. It defines the various roles our maintainers fill, how to become a maintainer, and how project-level decisions are made.
2020

21-
## Contributor Ladder
21+
# Contributor Ladder
2222

2323
The Podman project has a number of maintainer roles arranged in a ladder. Each role is a rung on the ladder, with different responsibilities and privileges. Community members generally start at the first levels of the "ladder" and advance as their involvement in the project grows. Our project members are happy to help you advance along the contributor ladder. At all levels, contributors are required to follow the CNCF Code of Conduct (COC).
2424

@@ -165,11 +165,13 @@ Emeritus Maintainers have no responsibilities or requirements beyond those of an
165165

166166
---
167167

168-
## Maintainers File
168+
# Maintainers File
169169

170170
The definitive source of truth for maintainers of a repository is the MAINTAINERS.md file in that repository. The MAINTAINERS.md file in the main Podman repository is used for project-spanning roles, including Core Maintainer and Community Manager. Some repositories in the project will also have an OWNERS file, used by the CI system to map users to roles. Any changes to the OWNERS file must make a corresponding change to the MAINTAINERS.md file to ensure that file maintains up to date. Most changes to MAINTAINERS.md will require a change to the repository’s OWNERS file (e.g. adding a Reviewer) but some will not (e.g. promoting a Maintainer to a Core Maintainer, which comes with no additional CI-related privileges).
171171

172-
## Inactivity
172+
---
173+
174+
# Inactivity
173175

174176
* Inactivity is measured by one or more of the following:
175177
* Periods of no contribution of code, pull request review, or participation in issue triage for longer than 12 months
@@ -178,20 +180,26 @@ The definitive source of truth for maintainers of a repository is the MAINTAINER
178180
* Involuntary removal or demotion
179181
* Being asked to move to Emeritus status
180182

181-
## Involuntary Removal or Demotion
183+
---
184+
185+
# Involuntary Removal or Demotion
182186

183187
Involuntary removal/demotion of a contributor happens when responsibilities and requirements aren't being met. This may include repeated patterns of inactivity, an extended period of inactivity, a period of failing to meet the requirements of your role, and/or a violation of the Code of Conduct. This process is important because it protects the community and its deliverables while also opening up opportunities for new contributors to step in.
184188

185189
Involuntary removal or demotion of Maintainers and Reviewers is handled through a vote by a majority of the current Maintainers. Core Maintainers may be involuntarily removed by a majority vote of current Core Maintainers or, if all Core Maintainers have stepped down or are inactive according to the inactivity policy, by a supermajority (66%) vote of maintainers.
186190

187-
## Stepping Down/Emeritus Process
191+
---
192+
193+
# Stepping Down/Emeritus Process
188194
If and when contributors' commitment levels change, contributors can consider stepping down (moving down the contributor ladder) vs moving to emeritus status (completely stepping away from the project).
189195

190196
Maintainers and Reviewers should contact the Maintainers about changing to Emeritus status, or reducing your contributor level. Core Maintainers should contact other Core Maintainers.
191197

192-
## Updates to this document
198+
---
199+
200+
# Updates to this document
193201
Updates to this Governance document require approval from a supermajority (66%) vote of the Core Maintainers.
194202

195-
## Contact
203+
# Contact
196204
* For inquiries, please reach out to:
197205
* [Tom Sweeney, Community Manager]([email protected])

0 commit comments

Comments
 (0)