Article version: Enterprise Server 2.17
Managing contributors and teams
You can manage the people and teams included in metrics and reports.
GitHub Insights is available with GitHub One. For more information, see "GitHub's products."
In this article
- About contributors and teams in GitHub Insights
- Editing a contributor
- Managing contributor visibility
- Merging contributor data
- Auto-merging contributors
- Manually merging contributors
- Unmerging a contributor
- Managing teams in GitHub Insights
- Creating a custom team
- Adding contributors to a custom team
- Removing a contributor from a custom team
- Renaming a custom team
- Deleting a custom team
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.
- In GitHub Insights, click Settings.
- Under Settings, click Contibutors.
- To the right of the contributor you want to manage, click Edit.
- Under "First Name", type the contributor's first name.
- Under "Last Name", type the contributor's last name.
- Click Rename.
Managing contributor visibility
Hiding a contributor excludes all data associated with that contributor from all metrics.
- In GitHub Insights, click Settings.
- Under Settings, click Contibutors.
- To the right of the contributor you want to manage, click Edit.
- Select or deselect Show contributor.
- 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
- In GitHub Insights, click Settings.
- Under Settings, click Contibutors.
- Under "All Contributors", click Auto-Merge
- Optionally, to exclude a contributor from being merged, to the right of the contributor, click Skip.
- For each group, select a primary contributor.
- Click Merge All.
Manually merging contributors
- In GitHub Insights, click Settings.
- Under Settings, click Contibutors.
- Select the contributors you want to merge.
- Under "All Contributors", click Merge.
- Select a primary contributor.
- Click Merge accounts.
Unmerging a contributor
- In GitHub Insights, click Settings.
- Under Settings, click Contibutors.
- 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
- In GitHub Insights, click Settings.
- Under Settings, click Teams.
- To the right of "Teams", click Create Team.
- Under "Team Name", type a unique name for your team.
- Click Create.
Adding contributors to a custom team
- In GitHub Insights, click Settings.
- Under Settings, click Teams.
- Next to the team you'd like to add contributors to, click Edit Team.
- Under "Contributors", use the drop-down menu and select a contributor.
- Click Done.
Removing a contributor from a custom team
- In GitHub Insights, click Settings.
- Under Settings, click Teams.
- Next to the team you'd like to add contributors to, click Edit Team.
- To the right of the contributor you'd like to remove, click .
Renaming a custom team
- In GitHub Insights, click Settings.
- Under Settings, click Teams.
- Next to the team you'd like to add contributors to, click Edit Team.
- Under "Team Name", type a unique name for your team.
- Click Rename.
- Click Done.
Deleting a custom team
- In GitHub Insights, click Settings.
- Under Settings, click Teams.
- Next to the team you'd like to add contributors to, click Edit Team.
- Click Delete Team.
- Click Confirm.