Skip to content

Governance template updates: org diversity, lifecycle, and voting module - #53

Open
angellk wants to merge 1 commit into
cncf:mainfrom
angellk:feat/governance-template-updates
Open

Governance template updates: org diversity, lifecycle, and voting module#53
angellk wants to merge 1 commit into
cncf:mainfrom
angellk:feat/governance-template-updates

Conversation

@angellk

@angellk angellk commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Summary

Updates to CNCF governance templates based on patterns observed across 71 graduated and incubating project governance reviews. Adds guidance and structural mechanisms to help projects maintain organizational diversity as they grow.

Changes to existing templates

  • GOVERNANCE-maintainer.md: Added "When to Evolve This Governance" section with transition signals (decisions stalling, no contributor path, single-org dominance, subproject divergence)
  • GOVERNANCE-elections.md: Added term renewal enforcement (30-day deadline), governance/code alignment check, recommended minimum 5 seats
  • GOVERNANCE-subprojects.md: Added per-subproject organizational diversity tracking guidance
  • MAINTAINERS.md: Added emeritus section with inactivity threshold guidance, affiliation update requirement (30-day currency)

New template

  • GOVERNANCE-org-balanced-voting.md: Reusable module any governance model can adopt. Counts votes per organization (not per person) on governance decisions. Includes implementation examples for maintainer council, steering committee, and federated subproject models. Referenced by cncf/toc#2265 as the template for the new graduation org-balance requirement.

Rationale

  • Org-balanced voting is the strongest observed predictor of sustained organizational diversity across CNCF projects. No template existed for this until now.
  • Projects using the Maintainer Council template often need to evolve but lack guidance on when. Transition signals are documented in every governance review but were not in the template.
  • Multiple graduated projects have lapsed governance (expired steering terms, overdue elections). Term renewal enforcement prevents this.
  • Many projects list inactive maintainers indefinitely, creating an appearance of diversity that does not reflect actual governance. Emeritus guidance normalizes the practice of moving inactive maintainers.

Companion PR

  • cncf/toc#2265 strengthens governance criteria in the incubation and graduation application templates, referencing the new org-balanced voting module.

Add "When to Evolve" section to Maintainer Council template with
transition signals. Add term renewal enforcement and governance/code
alignment guidance to Steering Committee Elections template. Add
per-subproject org diversity tracking to Federated Subprojects
template. Add emeritus section, inactivity threshold guidance,
and affiliation update requirement to MAINTAINERS template.

New: Org-Balanced Voting module - a reusable governance module
any project can adopt to prevent organizational concentration
of governance decisions, with implementation examples for all
three governance models.

Signed-off-by: Karena Angell <kangell@redhat.com>
Signed-off-by: Karena Angell <karena.angell@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant