Skip to content

Rewrite GOVERNANCE.md: subprojects, maintainer committees, contributor ladder #67

Description

@gbartolini

Draft the updated GOVERNANCE.md reflecting the federated subproject model.

Split from the original scope (see epic #65): this ticket now covers
the subproject/technical-authority split and contributor ladder only. The
Steering Committee's target composition (seats, org cap, staggered terms,
elections) moves to #70, and org-balanced voting stays with #68, so the
two pieces can be reviewed and merged independently — subprojects first,
then Steering's composition.

Acceptance criteria

  • Define the four subprojects and their repo scope:
    • Core: cloudnative-pg, api, machinery, barman-cloud
    • Supply Chain: charts, artifacts, community-operators, postgres-containers, postgres-extensions-containers, pgbouncer-containers, postgis-containers, postgres-trunk-containers, daggerverse, ciclops, chaos-testing, github-test
    • Community, Docs & Ecosystem: docs, cloudnative-pg.github.io, cnpg-playground, grafana-dashboards, webtest
    • Extensibility: cnpg-i, cnpg-i-machinery, plugin-barman-cloud, klio, cnpg-i-hello-world, postgres-keycloak-oauth-validator
  • Document that governance, .project, .github, cnpg-infra, and cnpg-template sit outside any subproject, administered directly by Steering
  • Each subproject has its own self-selecting maintainer committee holding technical authority over its components (subprojects/*.md, MAINTAINERS.md)
  • Introduce the Component Owner / Subproject Maintainer contributor ladder (CONTRIBUTOR_LADDER.md)
  • Enumerate what the Steering Committee owns vs. what stays with subproject maintainer committees
  • For this step, the Steering Committee is the existing group of Maintainers (MAINTAINERS.md), deciding under the existing per-person voting rules (lazy consensus, simple majority, ⅔ for governance changes) — its target composition (seats, org cap, elections) is explicitly out of scope here, see Form the Steering Committee and hold first meeting #70
  • Name and define the Infrastructure Team (delegated by Steering; the existing admins GitHub team)
  • PR reviewed and merged in cloudnative-pg/governance

Context

This is the single largest deliverable in the restructuring: most other
tickets in this epic depend on the definitions here. Split from the
original single-PR scope specifically so subprojects/ladder can land and
be reviewed on their own footing, without also asking reviewers (and,
later, the TOC) to evaluate the Steering Committee's composition and
org-balanced voting in the same pass.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

Projects

No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions