How to get started
Create Team
- Once logged into Syracuse University's instance is to create a GitHub Team - Create Team
- To enable easier collaboration and discovery in the platform ITS 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 are not recommended 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.
Repositories are used to hold files and represent an entity that can have permissions/roles applied to it. Common reasons for creating a repository would be to hold software project source code, scripts used to setup/configure a service, or documenting some process or procedure.
Crete Repository
Create a new GitHub repository - Create
Name for repositories must be unique in the Syracuse University GitHub organization.