Teams
Teams allow you to organize members of an organization into groups and grant these groups targeted access to repositories. Changes to a team immediately affect all repositories the team has access to.
The following article provides an overview of teams: https://docs.github.com/en/organizations/organizing-members-into-teams/about-teams
Creating a team
The following article shows how to create a team: https://docs.github.com/en/organizations/organizing-members-into-teams/creating-a-team
Adding members to a team
The invited member must already be a member of the organization. External collaborators cannot be added to teams.
The following article shows how to add a member to a team: https://docs.github.com/en/organizations/organizing-members-into-teams/adding-organization-members-to-a-team
Role within a team
Each member of a team has one of two roles:
| Role | Description |
|---|---|
| Member | Can use the contents of the team. |
| Maintainer | Can manage members, rename the team, and adjust the team's repository access. |
The following article shows how to assign a role within a team: https://docs.github.com/en/organizations/organizing-members-into-teams/assigning-the-team-maintainer-role-to-a-team-member#promoting-an-organization-member-to-team-maintainer
Configuring repository access for a team
The following article shows how to manage repository access for a team: https://docs.github.com/en/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/managing-team-access-to-an-organization-repository.
Team hierarchies (sub-teams)
Teams can be structured hierarchically. A sub-team does not automatically inherit the permissions of its parent team, but can be notified when the parent team is @mentioned.
@mentioning a team
In issues, pull requests, and comments, a team can be mentioned via @Organization/teamname. All members of the team will receive a notification (unless the team is set to Secret).
Deleting a team
Deleting a team automatically revokes all repository access granted through it from all members.
The following article shows the process of deleting a team: https://docs.github.com/en/organizations/organizing-members-into-teams/deleting-a-team.