Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 14 additions & 4 deletions .github/ISSUE_TEMPLATE/template-graduation-application.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,6 +93,10 @@ Note: this section may be augmented by the completion of a Governance Review fro

<!-- (Project assertion goes here) -->

- [ ] **Commit to an annual governance health check on maintainer organizational composition.** _(A lightweight self-assessment to detect post-graduation governance concentration trends early.)_
Comment thread
angellk marked this conversation as resolved.

<!-- (Project assertion goes here) -->

### Required

- [ ] **Clear and discoverable project governance documentation.**
Expand Down Expand Up @@ -131,7 +135,11 @@ Note: this section may be augmented by the completion of a Governance Review fro

<!-- (Project assertion goes here) -->

- [ ] **Project maintainers from at least 2 organizations that demonstrates survivability.**
- [ ] **Project maintainers from at least 2 organizations that demonstrates survivability.** _(Verified through the current project maintainer list, including affiliations. Use [LFX Insights](https://insights.lfx.linuxfoundation.org/) where available to corroborate organizational contribution patterns; explain any unavailable or conflicting data.)_

<!-- (Project assertion goes here) -->

- [ ] **Document and demonstrate an org-balance mechanism for governance decisions** _(such as org-balanced voting, steering committee with org caps, or equivalent structural protection ensuring no single organization controls governance decisions regardless of maintainer composition. See [Org-Balanced Voting](https://github.com/cncf/project-template/blob/main/GOVERNANCE-org-balanced-voting.md) for a reusable template.)_

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For reviewers - the proposed Org-Balanced Voting doc is in a PR.


<!-- (Project assertion goes here) -->

Expand Down Expand Up @@ -161,12 +169,14 @@ Note: this section may be augmented by the completion of a Governance Review fro

### Suggested

- [ ] **Contributor ladder with multiple roles for contributors.**

<!-- (Project assertion goes here) -->
N/A

### Required

- [ ] **Contributor ladder with multiple roles for contributors, with demonstrated evidence of the ladder producing maintainers from more than one contributing organization, as applicable.**

<!-- (Project assertion goes here) -->

- [ ] **Clearly defined and discoverable process to submit issues or changes.**

<!-- (Project assertion goes here) -->
Expand Down
16 changes: 9 additions & 7 deletions .github/ISSUE_TEMPLATE/template-incubation-application.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,6 +93,12 @@ Note: this section may be augmented by the completion of a Governance Review fro

<!-- (Project assertion goes here) -->

- [ ] **If the project has subprojects: subproject leadership, contribution, maturity status documented, including add/remove process.**

<!-- (Project assertion goes here) -->

### Required

- [ ] **Clear and discoverable project governance documentation.**

<!-- (Project assertion goes here) -->
Expand Down Expand Up @@ -121,11 +127,9 @@ Note: this section may be augmented by the completion of a Governance Review fro

<!-- (Project assertion goes here) -->

- [ ] **If the project has subprojects: subproject leadership, contribution, maturity status documented, including add/remove process.**
- [ ] **Maintainer affiliations are current and a policy is in place requiring updates within 30 days of employment changes.** _(If affiliations have lapsed, document how the project identified and corrected them.)_

<!-- (Project assertion goes here) -->

### Required
<!-- (Project assertion goes here) -->

- [ ] **Document complete list of current maintainers, including names, contact information, domain of responsibility, and affiliation.**

Expand Down Expand Up @@ -155,14 +159,12 @@ Note: this section may be augmented by the completion of a Governance Review fro

Note: this section may be augmented by the completion of a Governance Review from the Project Reviews subproject.

### Suggested
### Required

- [ ] **Contributor ladder with multiple roles for contributors.**

<!-- (Project assertion goes here) -->

### Required

- [ ] **Clearly defined and discoverable process to submit issues or changes.**

<!-- (Project assertion goes here) -->
Expand Down
15 changes: 15 additions & 0 deletions operations/dd-toc-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -185,6 +185,21 @@ TOC members who sponsor projects seeking graduation are expected to review the r

If a project is a specification project such as the TUF, SPIFFE and in-toto projects, there really is very little additional development that would need to happen and it is reasonable for the specification project to have only a few maintainers. For a specification project, it is required to have at least one implementation and that reference implementation DOES NOT need to be part of the project undergoing Due Diligence. The reference implementation should have sufficient adoption to assess maturity and viability of the specification. In many successful specifications, different adopters will implement their own copy for a variety of reasons. Each individual implementation may have limited diversity of maintainers, adoption, etc. but as a whole it can be broad and diverse.

#### Governance concentration and practice period

During DD, TOC members should review the project's organizational contribution concentration using [LFX Insights](https://insights.lfx.linuxfoundation.org/) to corroborate the maintainer list. For projects with **>75% organizational dependency** and no org-balance mechanism (such as [org-balanced voting](https://github.com/cncf/project-template/blob/main/GOVERNANCE-org-balanced-voting.md), steering committee with org caps, or equivalent structural protection), the TOC recommends the project implement governance changes and demonstrate them in practice for **3 months** before the DD continues.

Exit criteria for the practice period:

- Org-balanced voting or steering committee adopted and documented
- At least 3 governance meetings held with published minutes
- At least one governance decision made through the new process
- No regression in LFX org dependency

This is not punitive -- it verifies that governance works under real conditions before the project moves forward. Projects with lower concentration or existing structural protections may proceed without a practice period. The TOC member should record the decision (whether a practice period is needed and why) in the DD PR.

For governance best practices and anti-patterns to look for during DD, see the [governance guidance blog post](https://www.cncf.io/blog/), the [governance templates](https://contribute.cncf.io/projects/best-practices/governance/templates/), and the [governance remediation process](governance-remediation-process.md).

### Finalizing the Due Diligence

When the TOC has finished their criteria evaluation, they should move the project's card on the [Application to Move Levels board](https://github.com/orgs/cncf/projects/27/views/9) to "Adopter Interviews & Project Discussion" and re-engage the project to elevate and discuss any items needing clarity, correction, or improvement. This includes notifying the project of any recommendations. Recommendations and discussion points may be copied into the kick-off document to facilitate discussion and to provide for additional context and discussion with the project until they are finalized.
Expand Down