Merge pull request #394 from scottrigby/document-maintainer-groups

HIP: Document and Track maintainer groups

Author: scottrigby

Teams.md

@@ -18,6 +18,7 @@ restricted markdown format and can be found in the
 - [hip-0004: Document backwards-compatibility rules](hip-0004.md)
 - [hip-0005: Helm Org Maintainers and Deprecated Projects](hip-0005.md)
 - [hip-0006: OCI Support](hip-0006.md)
+- [hip-0007: Document and Track maintainer groups](hip-0007.md)
 - [hip-0008: Add descriptions to custom completions](hip-0008.md)
 - [hip-0009: Transitioning Security Team Members on Project Deprecation](hip-0009.md)
 - [hip-0010: Distributed responsibility for picking](hip-0010.md)
@@ -34,4 +35,4 @@ restricted markdown format and can be found in the
 - [hip-0023: Utilize Server Side Apply for installs/upgrades](hip-0023.md)
 - [hip-0024: Improve the Helm Documentation](hip-0024.md)
 - [hip-0025: Better Support for Resource Creation Sequencing](hip-0025.md)
-- [hip:0026: H4HIP: Wasm plugin system](hip-0026.md)
+- [hip-0026: H4HIP: Wasm plugin system](hip-0026.md)

hips/README.md

@@ -0,0 +1,84 @@
+---
+hip: "0007"
+title: "Document and Track maintainer groups"
+authors: [ "Matt Farina <[email protected]>", "Scott Rigby <[email protected]>" ]
+created: "2025-10-07"
+type: "process"
+status: "draft"
+---
+
+## Abstract
+
+There are numerous Helm maintainer groups where each can have zero or more Git
+repositories associated with them. This process provides a centralized method
+to document and track the maintainer groups, maintainers, and associated repos.
+
+## Motivation
+
+The current design uses a collection of documented and access controls to track
+this information while there are several gaps in the information. The Teams.md
+file attempted to track the different teams (i.e. maintainer groups, the org
+maintainers, etc).
+
+The repositories owned by a maintainer group, and the members of a group are
+not documented but are instead tracked via GitHub teams. The owners are
+scattered in various locations that are not consistent. In some cases they
+cannot be consistent (e.g. community management which does not have a GitHub
+repo). This has lead to confusion with the Org Maintainers and others.
+
+## Rationale
+
+There is currently no consistent manner to document the codebases associated with
+a maintainer group or the members of a maintainer group. There are two examples we can look
+at for this situation.
+
+First, there are maintainer groups responsible for multiple repositories. Charts and the
+Org maintainers groups are two examples with multiple repositories.
+There is no location to publicly document this situation.
+
+Second, not all maintainer groups own a repository. Community management is an example
+of a maintainer group that does a significant amount of work without owning a source
+repository.
+
+This HIP aims to provide a single source of document to discover maintainer group
+repositories and owners.
+
+## Specification
+
+The source of truth will be a YAML file name [`maintainer-groups.yaml`](../maintainer-groups.yaml)
+stored at the root of the Helm community repository. It will have the following
+structure:
+
+```
+maintainerGroups:
+- name: Helm Core
+  ownersLink: https://raw.githubusercontent.com/helm/helm/master/OWNERS
+  repos:
+  - https://github.com/helm/helm
+  mailingList: [email protected]
+- name: Charts
+  owners:
+  - unguiculus
+  - ...
+  emeritus:
+  - foxish
+  - ...
+  repos:
+  - https://github.com/helm/chart-releaser-action
+  - https://github.com/helm/charts-repo-actions-demo
+  - ...
+```
+
+A maintainer group can only have either `ownersLink` (a URL to the location of the
+owners list) or `owners` (a list of owners). It cannot have both. This enables
+those who do not have a Git repo (e.g., community managers) and those with
+multiple repos and no primary one (e.g., charts) to have a documented list.
+
+When `owners` is used it can have an accompanying `emeritus`. When `ownersLink`
+is used the emeritus is expected to be listed in that file.
+
+## References
+
+* [Helm Governance](https://github.com/helm/community/blob/master/governance/governance.md)
+  documents maintainer groups.
+* The [Teams.md file can be referenced in the community history](https://github.com/helm/community/blob/ecedb3ddea57749580bc4800cb1492fce9c9b332/Teams.md).

hips/hip-0007.md

@@ -0,0 +1,65 @@
+maintainerGroups:
+- name: Helm Org Maintainers
+  ownersLink: https://github.com/helm/community/blob/main/MAINTAINERS.md
+  repos:
+  - https://github.com/helm/community
+  - https://github.com/helm/pull-sizer
+  - https://github.com/helm/specs
+  - https://github.com/helm/query-store-quay-logs
+  - https://github.com/helm/github-webhook-dco-labeler
+  - https://github.com/helm/charts-check-pr-title
+  - https://github.com/helm/repo-audit
+  - https://github.com/helm/examples
+  mailingList: [email protected]
+- name: Security team
+  ownersLink: https://github.com/helm/community/blob/main/SECURITY.md
+  mailingList: [email protected]
+- name: Helm Core
+  ownersLink: https://raw.githubusercontent.com/helm/helm/master/OWNERS
+  repos:
+  - https://github.com/helm/helm
+  mailingList: [email protected]
+- name: Charts
+  owners:
+  - lachie83
+  - sameersbn
+  - unguiculus
+  - scottrigby
+  - mattfarina
+  - davidkarlsen
+  - paulczar
+  - cpanato
+  - jlegrone
+  - maorfr
+  emeritus:
+  - foxish
+  - linki
+  - mgoodness
+  - prydonius
+  - seanknox
+  - viglesiasce
+  repos:
+  - https://github.com/helm/chart-releaser-action
+  - https://github.com/helm/charts-repo-actions-demo
+  - https://github.com/helm/chart-testing-action
+  - https://github.com/helm/chart-testing
+  - https://github.com/helm/charts-tooling
+  - https://github.com/helm/chart-releaser
+  - https://github.com/helm/homebrew-tap
+  - https://github.com/helm/kind-action
+  mailingList: [email protected]
+- name: Website
+  ownersLink: https://raw.githubusercontent.com/helm/helm-www/master/OWNERS
+  repos:
+  - https://github.com/helm/helm-www
+- name: Community Management
+  owners:
+  - karenhchu
+- name: Chartmuseum
+  ownersLink: https://raw.githubusercontent.com/helm/chartmuseum/main/OWNERS
+  repos:
+  - https://github.com/helm/chartmuseum
+- name: Mapkubeapis plugin
+  ownersLink: https://github.com/helm/helm-mapkubeapis/blob/main/OWNERS
+  repos:
+  - https://github.com/helm/helm-mapkubeapis