diff --git a/.github/ISSUE_TEMPLATE/template-graduation-application.md b/.github/ISSUE_TEMPLATE/template-graduation-application.md index 9b3c80f87..7ce13ad68 100644 --- a/.github/ISSUE_TEMPLATE/template-graduation-application.md +++ b/.github/ISSUE_TEMPLATE/template-graduation-application.md @@ -93,6 +93,10 @@ Note: this section may be augmented by the completion of a Governance Review fro +- [ ] **Commit to an annual governance health check on maintainer organizational composition.** _(A lightweight self-assessment to detect post-graduation governance concentration trends early.)_ + + + ### Required - [ ] **Clear and discoverable project governance documentation.** @@ -131,7 +135,11 @@ Note: this section may be augmented by the completion of a Governance Review fro -- [ ] **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.)_ + + + +- [ ] **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.)_ @@ -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.** - - +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.** + + + - [ ] **Clearly defined and discoverable process to submit issues or changes.** diff --git a/.github/ISSUE_TEMPLATE/template-incubation-application.md b/.github/ISSUE_TEMPLATE/template-incubation-application.md index 4eafe957c..5e934e5e9 100644 --- a/.github/ISSUE_TEMPLATE/template-incubation-application.md +++ b/.github/ISSUE_TEMPLATE/template-incubation-application.md @@ -93,6 +93,12 @@ Note: this section may be augmented by the completion of a Governance Review fro +- [ ] **If the project has subprojects: subproject leadership, contribution, maturity status documented, including add/remove process.** + + + +### Required + - [ ] **Clear and discoverable project governance documentation.** @@ -121,11 +127,9 @@ Note: this section may be augmented by the completion of a Governance Review fro -- [ ] **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.)_ - - -### Required + - [ ] **Document complete list of current maintainers, including names, contact information, domain of responsibility, and affiliation.** @@ -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.** -### Required - - [ ] **Clearly defined and discoverable process to submit issues or changes.** diff --git a/operations/dd-toc-guide.md b/operations/dd-toc-guide.md index c53905466..1992bf4c4 100644 --- a/operations/dd-toc-guide.md +++ b/operations/dd-toc-guide.md @@ -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.