Skip to content

Commit

Permalink
Add team guidance section to org-owners-guide
Browse files Browse the repository at this point in the history
  • Loading branch information
spiffxp committed Feb 14, 2018
1 parent d853d7d commit 77666f8
Showing 1 changed file with 29 additions and 1 deletion.
30 changes: 29 additions & 1 deletion org-owners-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).

0 comments on commit 77666f8

Please sign in to comment.