From a552910f17396fc29f57894f1b58433d1605a913 Mon Sep 17 00:00:00 2001 From: Nikhita Raghunath Date: Wed, 6 Mar 2019 17:38:43 +0530 Subject: github-management: document team structure and process --- github-management/org-owners-guide.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) (limited to 'github-management/org-owners-guide.md') diff --git a/github-management/org-owners-guide.md b/github-management/org-owners-guide.md index 09df20ad..bd71de82 100644 --- a/github-management/org-owners-guide.md +++ b/github-management/org-owners-guide.md @@ -48,6 +48,8 @@ transfer in existing code. ## Team Guidance +### Nomenclature + Each organization should have the following teams: - teams for each repo `foo` @@ -76,6 +78,24 @@ for all orgs going forward. Notable discrepancies at the moment: org. This was a mistake that swapped the usual convention, and we would like to rename the team +### Structure and Process + +Guidelines on how to create and structure teams are described below: + +- Teams should not have any `maintainers` and everyone who should be part of +the team should be added in the `members` list. + - Note that because of how the GiHub API works, org admins still need to be + in the `maintainers` list for the teams they are a part of. +- The `privacy` of a team *must* be `closed`. +- A new team can be created or a member can be added to a team by +creating a PR against the [kubernetes/org] repo. The PR must be +approved by the relevant `OWNERS` or the SIG leads. + - For example, addition of a member to `foo-maintainers` must be approved + by the `OWNERS` of the repo `foo` or the leads of the SIG associated + with the repo. +- To rename a team, add the `previously: ` field to the team +and rename the `name` of the team to the new name. + ## Project Board Guidance Guidelines for project boards in the Kubernetes GitHub orgs are described below: @@ -109,3 +129,4 @@ Project](https://github.com/kubernetes/kubernetes-template-project), and the [GitHub Administration Team]: /github-management/README.md#github-administration-team [@kubernetes/owners]: https://github.com/orgs/kubernetes/teams/owners +[kubernetes/org]: https://github.com/kubernetes/org -- cgit v1.2.3