Teams

Teams help you organize members and control access to repositories. Members assigned to a team can access all repositories associated with that team.

Team Concepts

Team Membership

Members can belong to multiple teams. All team members have equal access to team resources.

Team Repository Access

When a repository is assigned to a team:

  • All team members can access the repository
  • Access is granted based on their organization role

Creating a Team

  1. Go to Teams
  2. Click New Team
  3. Enter a Team Name (e.g., "Engineering")
  4. Optionally add a Description
  5. Click Create Team

Managing Teams

Viewing Team Details

  1. Go to Teams
  2. Click View Team on a team
  3. View members and repositories

Editing a Team

  1. View the team details
  2. Click Edit
  3. Update the name or description
  4. Click Save Changes

Deleting a Team

  1. View the team details
  2. Click Delete Team
  3. Confirm the deletion

Deleting a team:

  • Removes all team associations
  • Does not delete members or repositories
  • Members lose team-based repository access

Team Members

Adding Members

  1. View the team details
  2. Under Members, click Add Member
  3. Select members from the organization
  4. Click Add Members

Members can be added individually or in bulk by selecting multiple users.

Removing Members

  1. View the team details
  2. Find the member in the list
  3. Click Remove

Pending Invitations

The team detail view shows:

  • Members tab - Current team members
  • Pending tab - Invited users assigned to this team

Pending invitations can be:

  • Resent - Send the invitation email again
  • Cancelled - Remove the invitation

Team Repositories

Adding Repositories

  1. View the team details
  2. Under Repositories, click Add Repository
  3. Select repositories from the organization
  4. Click Add Repositories

Removing Repositories

  1. View the team details
  2. Find the repository in the list
  3. Click Remove

Use Cases

Department Teams

Organize by department:

  • Engineering - Technical documentation
  • Sales - Sales materials and guides
  • HR - Employee handbook and policies

Project Teams

Organize by project:

  • Project Alpha - Project Alpha documentation
  • Project Beta - Project Beta documentation

Client Teams

For agencies or consultants:

  • Client A - Client A documentation
  • Client B - Client B documentation

Permissions

Team management requires specific permissions:

ActionRequired Role
View teamsAdmin (Members can only view teams they belong to)
Create teamsAdmin
Edit teamsAdmin
Delete teamsAdmin
Add membersAdmin
Remove membersAdmin
Add repositoriesAdmin
Remove repositoriesAdmin

Team-Based Access for Members

Members can only view repositories and teams they are assigned to via team membership. This allows fine-grained control over what each Member can access:

  • Add Members to specific teams to grant access to those team's repositories
  • Remove Members from teams to revoke access
  • Members cannot see repositories or teams they are not assigned to