How to set up GitHub teams for a collection

This guide explains how to configure GitHub teams and permissions for a new collection in the Open Terms Archive organization. For third-party collections outside the organization, you can handle permissions according to your own needs.

Prerequisites

• Admin access to the OpenTermsArchive GitHub organization
• The collection name and icon
• List of team members to add
• The collection repositories (declarations, snapshots, versions and, if any, tracking results) already created

Steps

1. Create the collection team:

   1. Go to GitHub’s new team page
   2. Enter the collection name as the team name
   3. Upload the collection icon from the website as the team avatar
   4. Set the description to: “Maintainers of the <collection_name> collection”
   5. Click “Create team”

2. Add team members:

   1. Navigate to the team’s “Members” tab
   2. Click “Add member”
   3. Search and select each member to add
   4. Confirm their addition

3. Configure repository access for the collection team:

   1. Go to the team’s “Repositories” tab
   2. Add the declarations repository with “Maintain” access
   3. Add the snapshots repository with “Triage” access
   4. Add the versions repository with “Triage” access
   5. Add the tracking results repository, if any, with “Triage” access

   Note: Snapshots, versions and tracking results repositories are limited to “Triage” access to prevent data corruption

4. Configure bot access:

   1. Navigate to the Bots team
   2. Go to the “Repositories” tab
   3. Add all the collection repositories (declarations, snapshots, versions and, if any, tracking results) with “Write” access

Verification

After completing these steps, verify that:

• The team appears in the organization’s teams list
• Team members can access all repositories with appropriate permissions
• The Bots team has write access to all repositories