GitHub - Do you use GitHub teams for collaborator permissions?

Last updated by Gordon Beeming [SSW] 7 months ago.See history

You can use teams within a repository to manage a whole group's permissions instead of setting permissions for each new member of the organisation.

See Organizing members into teams.

GoodExampleUsingTeams
Figure: Good example - Using a good teams structure to organize access

Correctly configuring your organisation's teams structure will make it easy to give members the permissions level that they need. You can add teams to repositories to manage their roles.

TeamsOnRepo
Figure: Good example - Using teams to assign roles in a repository

Another benefit of using teams is that you can mention a whole team in a discussion instead of individual members. See Mentioning people and teams

Use teams as maintainers over individuals

When you add a team to a repository, you can give the team a role that determines their access level to the repository. You can also add teams to issues and pull requests to manage their access to those resources. Often individuals are added to repositories as administrators, but this is not a good idea as it gives them destructive access to the repository. Instead, add a team to the repository and give the team the maintainer role.

individuals added as admins
Figure: Bad example - Individuals should not have Admin access to a repository

teams added as maintainers
Figure: Good example - Teams should have Maintainer access to a repository

We open source. Powered by GitHub