Add team guidance section to org-owners-guide
This commit is contained in:
parent
d853d7d526
commit
77666f8983
|
@ -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).
|
||||
|
|
Loading…
Reference in New Issue