Creating and Managing Teams
Creating a team
Go to Teams in the sidebar and click Create team. The wizard walks you through four steps.
Info. Give the team a name (required, up to 80 characters) and an optional description. The name is what shows up in the top navigation switcher.
Members. Search for developers in your organization by username, display name, or email. The people you add here are whose activity shows up in team analytics, and their recent repo history is used to suggest repositories in the next step.
Repositories. Pick the repos that belong to this team. Repos your chosen members have recently worked in are pre-selected as a starting point. Adjust as needed.
Settings. Toggle auto-sync if you want (see Auto-sync below), then click Create team. The new team is automatically set as the active team in the top navigation once it is created.
Managing an existing team
Open the Teams page and click any team to get to its detail view. The detail view has three tabs: Overview, Members, and Repos.
Members
To add someone, go to the Members tab and search by username, display name, or email. Click their name to add them.
To remove someone, click the X next to their name. This only removes them from the team inside Codity. It has no effect on their access to repositories in the underlying version control system.
Repositories
To add a repo, go to the Repos tab, type owner/repo-name in the input, select the provider, and click Add.
To remove a repo, click the X next to it. What happens depends on how the repo got there:
Manually added repos are removed from the team entirely.
Auto-synced repos get marked as excluded instead of deleted. An excluded repo will not come back the next time auto-sync runs, even if team members are active on it. To undo an exclusion, just add the repo manually again.
Auto-sync
When auto-sync is on, Codity watches team member activity and adjusts the repo list over time. Repos where members open or review PRs can be added automatically; repos with no recent activity from team members can be dropped.
Repos you add manually are always kept regardless of activity level. Repos you have excluded are always kept out regardless of activity level.
To toggle auto-sync, open the team detail view and use the setting on the Overview tab.
Switching between teams
The team switcher sits in the top navigation bar next to the Codity logo. Clicking it opens a dropdown with all your teams and the All repos option. Switching teams takes effect immediately without a page reload.
Your selection persists across sessions. If a team gets deleted while it is active, the switcher falls back to All repos automatically.
Deleting a team
Open the team detail view, scroll to the bottom of the Overview tab, and click Delete team. This removes the team and all its member and repo associations from Codity. Nothing changes in your version control system.
Troubleshooting
A repo I added is not showing in analytics. It may have been marked as excluded. On the Repos tab, excluded repos show an excluded badge. Remove it and re-add the repo manually to restore it.
A team member's activity is not reflected. The member needs to have signed in to Codity at least once so their login is recognized. If their repos still are not appearing, confirm those repos are in the team's list and are not excluded.
The team switcher shows "Connecting to your team." This shows briefly while the dashboard loads team data. If it does not go away, try refreshing. If the team was recently deleted, selecting All repos from the switcher will clear the stale state.
