diff --git a/org-owners-guide.md b/org-owners-guide.md index 3319cb70257..3d6a9d757eb 100644 --- a/org-owners-guide.md +++ b/org-owners-guide.md @@ -47,8 +47,36 @@ Note, this list is subject to change. There are more organization names that we are squatting on with possible future intentions. [For more details please see community issue #1407](https://github.com/kubernetes/community/issues/1407). +## Team Guidance + +Each organization should have the following teams: + +- teams for each repo `foo` + - `foo-admins`: granted admin access to the `foo` repo + - `foo-maintainers`: granted write access to the `foo` repo +- a `bots` team + - should contain bots such as @k8s-ci-robot and @linuxfoundation that are + neccessary for org and repo automation +- an `owners` team + - should be populated by everyone who has `owner` privileges to the org + - gives users the opportunity to ping owners as a group rather than having to + search for individuals + +**NB**: Not all organizations in use today currently follow this team guidance. +We are looking to coalesce existing teams towards this model, and use this model +for all orgs going forward. Notable discrepancies at the moment: + +- `foo-reviewers` teams that grant read access to each `foo` repo haven't + proven themselves useful. Reviews are now requested from sigs via + @sig-foo-pr-reviews teams, and read access is already granted to the public + at large. These don't need to be created going forward, and can be removed + if they're not actively being used. +- `admins-foo` and `maintainers-foo` teams as used by the kubernetes-incubator + org. This was a mistake that swapped the usual convention, and we would like + to rename the team + ## Repository Guidance Repositories have additional guidelines and requirements, such as the use of CLA checking on all contributions. For more details on those please see the -[Kubernetes Template Project](https://github.com/kubernetes/kubernetes-template-project). \ No newline at end of file +[Kubernetes Template Project](https://github.com/kubernetes/kubernetes-template-project).