GitHub Instructor Guide

创建UBC GitHub帐户

1. Go toactivate.github.ubc.ca, and log in with your CWL.
2. Read through the "Privacy Notification" and do one of the following:
   • Consent to using your CWL as-is by clicking the“我明白了”按钮, which acknowledges that other users can see your CWL username on your UBC GitHub account.
   • Delay your consent by clicking the"I will review this later" buttonto stop the creation of your UBC GitHub account.
3. If you clicked to consent, your UBC GitHub account will be created.
4. If you clicked to delay, you can repeat the steps above to provide your consent when you are ready.

登录UBC GitHub

1. Go tolearning.github.ubc.cato access the UBC GitHub Service for Teaching & Learning.
2. Use your UBC CWL username and password to log in.

Request a GitHub organization for your course

Organizations in GitHub are group accounts where members can collaborate on multiple projects (called repositories). UBC faculty and staff may request a GitHub organization for a course. The organization will be created and a team set up within it to auto-synchronize all students of your course as organization members. You will be able to manage member access to the organization's projects.

1. Fill out ourcontact formwith the following details:
   • Your CWL username
   • The course and section you want to pull in students from to become members of the organization
2. Instruct your students to create UBC GitHub accounts atactivate.github.ubc.ca, noting that they may change their CWL first, if they wish.
3. 激活您的请求后，自动同步可能需要长达两个小时才能将学生添加到Github组织后，激活他们的GitHub帐户后。之后，你会准备好。
4. Once your organization is created, you will be able to do any of the following:
   • Add unlimited collaborators and access full GitHub features on public repositories, with limited GitHub features on private repositories.
   • Grant different access levels of对你的组织权限andpermissions to individual repositories.
   • Createteams in your organization反映您的课程结构，例如创建镜像学生团队的团队。

Manage your GitHub organization

If you manage an organization (typically a course) on GitHub, you'll have the ability to invite new members as well as create additional teams and manage repositories within the organization. Repositories are places for projects where files are stored and built on, and teams are spaces where team members communicate and collaborate around projects.

邀请people to your organization

Registered students in the course and section will be auto-synchronized as members of your organization. You can invite co-instructors, teaching assistants, or other people to become members of your organization. People you invite to join your organization must be UBC GitHub members. This means they must have logged in to learning.github.ubc.ca at least once.

1. Go tolearning.github.ubc.cato log in to the UBC GitHub with your CWL.
2. Click your配置文件图标in the upper right, then chooseYour profile.
3. On the left side of your profile page, under "Organizations", click theicon为您的组织。
4. Click thePeople tab, then clickAdd member.
5. Type theusernameof the person you want to add, and click邀请.
6. Choose arolefor the person and, optionally, add the person to any teams in the organization.
7. ClickAdd memberto invite the person to join your organization.

Create teams for your organization

You can create standalone or hierarchical ("nested") teams to more easily manage access permissions for repositories and notifications ("mentions") to alert groups of people.

1. Go tolearning.github.ubc.cato log in to the UBC GitHub with your CWL.
2. Click your配置文件图标in the upper right, then chooseYour profile.
3. On the left side of your profile page, under "Organizations", click theicon为您的组织。
4. Click the团队标签, then clickNew team.
5. Enter thenamefor your new team and, optionally, type adescription.
6. If you're creating anested team, use the drop-down menu to choose a "parent" team your new team should sit underneath.
7. ClickCreate teamto create your new team.

Add organization members to your team

People you invite to join teams must be UBC GitHub members. This means they must have logged in to learning.github.ubc.ca at least once.

1. Go tolearning.github.ubc.cato log in to the UBC GitHub with your CWL.
2. Click your配置文件图标in the upper right, then chooseYour profile.
3. On the left side of your profile page, under "Organizations", click theicon为您的组织。
4. Click the团队标签, then on the bottom of the page, click the name of the team you want to add members to.
5. Click theMembers tab, then clickAdd a member.
6. Type theusernameof the person you want to add, and click邀请.

Create repositories for your organization

You can collaborate on projects by sharing files in repositories.

1. Go tolearning.github.ubc.cato log in to the UBC GitHub with your CWL.
2. In the upper right, click theplus icon, and selectNew repositoryfrom the drop-down menu.
3. In the owner drop-down, select the帐户to create the repository under.
4. Enter a name and description for your repository.
5. ClickCreate repositoryto create your new repository.