GitHub Classroom Setup

Setting up a new organization on GitHub Education

1. Go to GitHub Education

   • create a teacher account if you haven't already. Make sure you use your school email. It will require verification (usually a copy of your ID).

2. Click on Get benefits

3. Create a new organization (will take you to a different screen)

4. Choose Team For Open Source

   • Enter organization name
   • Enter email address
   • Select My personal account

5. Go back to GitHub Education and click Get benefits

6. Click on Upgrade next to the organization

7. Select Classroom for kind of organization

Create a classroom

1. Go to GitHub Classroom
2. Click on Grant access to an organization ...
3. Click on Grant next the organization
4. Go back to GitHub Classroom
5. Click on New classroom
6. Click on the organization you wish to enroll
7. Give it a name like 2400-fl-19-classroom
8. Now it's ready for assignments

Set up GitHub Actions to run students' projects (if needed)

Open the template repository for an assignment and click on Actions. Use a workflow appropriate for your project. You can customize the workflow by editing the .yml file under .github/workflows directory.

Set up Travis-CI (if needed)

Go to Travis-CI

1. Login with your GitHub account
2. Activate your organization under User Settings
3. Click on Review and add your authorized organization
4. Click Grant to grant access to the organization
5. It will take few minutes before the organization appears on Travis-CI website. Travis-CI will grant you 100 free builds for now
6. You have to email Travis-ci support to enable them for educational discount for unlimited builds

Creating an Assignment on GitHub Classroom

1. Go to GitHub Classroom
2. If you would like to distribute starter code, create a template repository with your starter code and modify the Setting by checking Template repository.
3. Add appropriate Actions or Travis-CI files for testing.
4. When you create a new assignment, you can point to this template as your starter code.

I recommend using private repositories and making sure the students don't have admin access to them.