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