Setting up a Team

Setting up a Team

Access is managed through teams rather than individual grants. A team groups the people working on a project or course, and repository permissions are assigned to the team. When someone joins or leaves, you change one team membership instead of auditing every repository.

Only organisation owners and existing team maintainers can create teams. If you need one, ask an administrator.

Creating a team

1. Go to the organisation, open the Teams tab and choose New team.
2. Name it clearly. Use the course code for a course, for example EEE2046F, or a short project name.
3. Add members, and set at least one maintainer to look after it.

Granting access

1. Open the repository, go to Settings, then Collaborators and teams.
2. Add the team and choose a permission level.

Grant the least permission that works. Most contributors need Write. Maintain suits tutors who manage issues and releases but should not change settings. Reserve Admin for the few who manage the repository itself.

Courses

For a course, create a team per course and add the cohort to it for the duration of the course. Remove them, or archive the repository, once the course ends. Never place student marks or personal data in a course repository. See the Contributing guide.