Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

Create a GitHub Team

Once logged into Syracuse University's instance, create a GitHub Team - Create Team

To enable easier collaboration and discovery in the platform consider names that include identification that is more specific to your area vs generalizing. For example, "infrastructure" may encompass multiple areas. Use "web hosting infrastructure" or "{dept}-infrastructure".  Where possible users should name their Team based on the following naming convention: "ITS-(Department/Team Name/Acronym)-(Role if required)". e.g. "ITS-CIS"

"Visible" teams are recommended so that collaboration can be made easier and requests to join can be made.

Nested Teams or building a hierarchy of parent/child teams in certain situations can have some advantages for large teams.  Child teams inherit the parent's access permissions, simplifying permissions management for large groups. Members of child teams also receive notifications when the parent team is @mentioned, simplifying communication with multiple groups of people. Generally, we do not recommend using nested teams unless required since the relationship of a child team to its parent may result in users having access to a repository that you did not intend.  If there is a new group of people working on a repository, create another Team.

In some situations, you may want to create separate Teams for differencing level of access to the Team's repositories.  For example, it may be required to create a Team named "ITS-IAM-Admins" to provide a smaller scope of user access to the Admin role of the Team's repositories instead of the whole "ITS-IAM" team.

Setup Team Maintainers so that requests to join the Team can be approved - Setup Maintainers

There should be at least two group maintainers so that if one person is unavailable another Team member can perform the administrative duties of Team maintenance.

Publicize your Team's GitHub URL so that other members of your department can join the GitHub Team.


 Join a GitHub Team

GitHub repository and project permissions are best managed with GitHub Teams.  if you have been given a Team name to join follow these steps.

Navigate to the Syracuse University Organization.

Select the "Teams" tab from the row of available options near the top of the page.

Search for the Team you would like to be a member of.

Select the Team, and click the "Request to join" button to send an access request to the Team Maintainers.

A Team Maintainer will now be able to review your request to join and will approve or deny based on their discretion.


  • No labels