Add team guidance section to org-owners-guide

This commit is contained in:
Aaron Crickenberger 2018-02-14 12:31:59 -08:00
parent d853d7d526
commit 77666f8983
1 changed files with 29 additions and 1 deletions

View File

@ -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).
[Kubernetes Template Project](https://github.com/kubernetes/kubernetes-template-project).