Managing contributors and teams

About contributors and teams in GitHub Insights

A contributor in GitHub Insights is an entity associated with GitHub Enterprise data. You can edit and hide contributors.

Sometimes, the same person can appear as more than one contributor. For example, if one person has used multiple commit email addresses in Git, there will be a unique contributor for each email address in GitHub Insights. You can merge multiple contributors to combine all the data from one person.

You can also group contributors into teams. You can use teams as a filter on reports. For more information, see "Viewing key metrics and reports."

Editing a contributor

You can edit a contributor's display name in GitHub Insights.

1. In GitHub Insights, click Settings.
   
2. Under Settings, click Contibutors.
   
3. To the right of the contributor you want to manage, click Edit.
   
4. Under "First Name", type the contributor's first name.
   
5. Under "Last Name", type the contributor's last name.
   
6. Click Rename.

Managing contributor visibility

Hiding a contributor excludes all data associated with that contributor from all metrics.

1. In GitHub Insights, click Settings.
   
2. Under Settings, click Contibutors.
   
3. To the right of the contributor you want to manage, click Edit.
   
4. Select or deselect Show contributor.
   
5. Click Done.

Merging contributor data

When you merge two or more contributors, the GitHub Insights data for those contributors becomes associated with one primary contributor. All of the merged contributor data belongs to the primary contributor in metrics.

You can merge contributors manually or automatically, based on contributors GitHub Insights has detected with matching names.

Auto-merging contributors

1. In GitHub Insights, click Settings.
   
2. Under Settings, click Contibutors.
   
3. Under "All Contributors", click Auto-Merge
   
4. Optionally, to exclude a contributor from being merged, to the right of the contributor, click Skip.
   
5. For each group, select a primary contributor.
   
6. Click Merge All.

Manually merging contributors

1. In GitHub Insights, click Settings.
   
2. Under Settings, click Contibutors.
   
3. Select the contributors you want to merge.
   
4. Under "All Contributors", click Merge.
   
5. Select a primary contributor.
   
6. Click Merge accounts.

Unmerging a contributor

1. In GitHub Insights, click Settings.
   
2. Under Settings, click Contibutors.
   
3. To the right of the contributor, click Unmerge.
   

Managing teams in GitHub Insights

There are two types of teams in GitHub Insights: teams imported from GitHub Enterprise and custom teams.

When an organization is added to GitHub Insights, all of the organization's teams are imported from GitHub Enterprise. You can search and filter by these teams in GitHub Insights. You can manage the teams in GitHub Enterprise.

You can create and manage custom teams in GitHub Insights. Custom teams may include members from multiple organizations in GitHub Enterprise.

Creating a custom team

1. In GitHub Insights, click Settings.
   
2. Under Settings, click Teams.
   
3. To the right of "Teams", click Create Team.
   
4. Under "Team Name", type a unique name for your team.
   
5. Click Create.

Adding contributors to a custom team

1. In GitHub Insights, click Settings.
   
2. Under Settings, click Teams.
   
3. Next to the team you'd like to add contributors to, click Edit Team.
   
4. Under "Contributors", use the drop-down menu and select a contributor.
   
5. Click Done.

Removing a contributor from a custom team

1. In GitHub Insights, click Settings.
   
2. Under Settings, click Teams.
   
3. Next to the team you'd like to add contributors to, click Edit Team.
   
4. To the right of the contributor you'd like to remove, click .
   

Renaming a custom team

1. In GitHub Insights, click Settings.
   
2. Under Settings, click Teams.
   
3. Next to the team you'd like to add contributors to, click Edit Team.
   
4. Under "Team Name", type a unique name for your team.
   
5. Click Rename.
   
6. Click Done.

Deleting a custom team

1. In GitHub Insights, click Settings.
   
2. Under Settings, click Teams.
   
3. Next to the team you'd like to add contributors to, click Edit Team.
   
4. Click Delete Team.
   
5. Click Confirm.