GitHub教练指南

The UBC GitHub Service for Teaching & Learning is a collaborative version-control toolavailable for academic use at UBC. Version-control tools are commonly used for managing code or other projects where you want a clear history of the development of shared work. UBC GitHub enables this collaboration and coordination for students and is powered by an on-campus version ofGitHub Enterprise与UBC的校园范围内的登录(CWL)合作。

成本 Yes Free
Bandwidth Yes Low demand
帆布集成 No 没有任何
隐私 Yes GitHub isFippa.符合要求和数据安全地存储在加拿大
类似的UBC支持的工具 Microsoft OneDriveis also centrally supported for real-time document collaboration

我可以用它吗?

You can use GitHub for a variety of classroom purposes:

  • Sharing code and projects across a course for students to build on
  • 收集和评估学生编码分配和实验室
  • Enabling student collaboration on projects
  • Letting students experiment with changes to a project (yours, theirs, or their peers’) without affecting the original version

What do I need to use GitHub?

A UBC GitHub account

UBC GitHub账户基于UBC CWL。具有有效CWL的任何学生或员工都可以使用下面概述的步骤来创建UBC GitHub帐户。

A supported web browser

github在您的Web浏览器中运行,并使用最新版本的Chrome,Edge,Firefox或Safari支持。

尖端

  • Students can change their CWL usernames before activating a UBC GitHub account,如果他们担心在GitHub中保留匿名。The “Privacy Notification” information when they set up a UBC GitHub account provides details on how to do this.
  • 你可以安装github桌面应用程序作为在Web界面中工作的替代方案。

How do I use GitHub?

您将首先需要使用CWL启用您的UBC GitHub帐户,并为您的课程申请GitHub组织。然后,您可以使用GitHub的所有常规功能进行教学和学习。

Click any bar below for instructions and tips for using GitHub.

创建UBC GitHub帐户

  1. Go toactivate.github.ubc.ca.,并使用您的CWL登录。
  2. 阅读“隐私通知”并执行以下操作之一:
    • 同意使用您的CWL AS-IS通过点击“我明白了”按钮, 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.

尖端

  • Your UBC GitHub account username is the same as your CWL username and is visible to other UBC GitHub users,这就是为什么需要同意使用UBC GitHub。
  • Students can change their CWL username before activating a UBC GitHub account,如果他们担心在GitHub中保留匿名。“隐私通知”信息设置UBC GitHub帐户时提供了有关如何执行此操作的详细信息。

Log in to UBC GitHub

  1. Go tolearning.github.ubc.cato access the UBC GitHub Service for Teaching & Learning.
  2. 使用您的UBC CWL用户名和密码登录。

尖端

  • 如果使用GitHub Desktop应用程序,您将使用GitHub Enterprise Server选项登录, entering "learning.github.ubc.ca" when prompted for an address.

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. 填写我们的contact form以下详情:
    • 您的CWL用户名
    • 您想要拉入学生的课程和部分成为组织的成员
  2. 指导学生创建UBC GitHub帐户activate.github.ubc.ca., noting that they may change their CWL first, if they wish.
  3. Once we activate your request, the auto-synchronization may take up to two hours to add students to the GitHub organization, after they activate their GitHub accounts. After that, you will be ready to go.
  4. 创建组织后,您将能够执行以下任何操作:

尖端

  • 您将能够创建其他团队并管理存储库作为GitHub组织的所有者。存储库是项目存储和构建的项目的地点,团队成员的空格是团队成员沟通和协作围绕项目进行协作。有关此内容的更多详细信息,请参阅下一组指令。
  • You can invite anyone to become a member of your organization, using their GitHub username, and you can edit or cancel an invitation any time before the person accepts.
  • 帐户可以not代表他人创造,所以学生需要激活他们的哥伦比亚大学吉斯ub accounts individually.

Manage your GitHub organization

如果您在GitHub上管理组织(通常是一门课程),您将有能力邀请新成员,并在组织中创建其他团队并管理存储库。存储库是项目存储和构建的项目的地点,团队成员的空格是团队成员沟通和协作围绕项目进行协作。

邀请人们到您的组织

课程中的注册学生和部分将作为组织成员自动同步。您可以邀请共同教师,教学助理或其他人成为您组织的成员。您邀请加入组织的人必须是UBC Github成员。这意味着它们必须至少登录到学习.github.ubc.ca至少一次。

  1. Go tolearning.github.ubc.ca使用CWL登录UBC GitHub。
  2. Click yourprofile icon在右上角,然后选择您的个人资料
  3. 在您个人资料页面的左侧,在“组织”下,单击iconfor your organization.
  4. 点击人们标签,然后点击Add member
  5. 输入用户名您要添加的人员,然后单击Invite
  6. 选择一个role对于该人而选择,将该人添加到组织中的任何团队中。
  7. ClickAdd member邀请该人加入您的组织。

创造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.ca使用CWL登录UBC GitHub。
  2. Click yourprofile icon在右上角,然后选择您的个人资料
  3. 在您个人资料页面的左侧,在“组织”下,单击iconfor your organization.
  4. 点击Teams tab,然后点击New team
  5. 输入namefor 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. Click创造teamto create your new 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.ca使用CWL登录UBC GitHub。
  2. Click yourprofile icon在右上角,然后选择您的个人资料
  3. 在您个人资料页面的左侧,在“组织”下,单击iconfor your organization.
  4. 点击Teams tab, then on the bottom of the page, click the name of the team you want to add members to.
  5. 点击成员标签,然后点击Add a member
  6. 输入用户名您要添加的人员,然后单击Invite

创造repositories for your organization

You can collaborate on projects by sharing files in repositories.

  1. Go tolearning.github.ubc.ca使用CWL登录UBC GitHub。
  2. In the upper right, click the加图标, and selectNew repositoryfrom the drop-down menu.
  3. 在所有者下拉,选择account创建存储库。
  4. 输入存储库的名称和描述。
  5. Click创建存储库to create your new repository.

尖端

  • 创建团队允许学生更轻松地协作并参与讨论with a smaller group of students. Each team will have a separate page for interacting.
  • When youcreate a nested team,嵌套(或“child”)团队将从父团队继承访问权限和通知, simplifying permissions management and communication for multiple groups of students.
  • You can send notifications to an entire teamby mentioning the team's name with GitHub’s @mention feature. You can also管理您如何接收GitHub通知
  • Help identify your repositories using what are called自述文件, which should give a brief overview of each project. A README file is usually the first item shown when someone visits your repository.
  • 使用您的存储库使用wikis on GitHub,这是一种有关您项目的深入信息的有用方法。

我在哪里可以获得github的更多支持?

Technical support

如果您对GitHub有问题:

支持您的学生:

  • 分享GitHub指南, which include instructions on getting started with GitHub and links to videos

Learn more


«查看所有工具