A step-by-step guide on setting up your GitHub Organization for classroom use.
GitHub Classroom automates the manual processes described in this guide and is the recommended way to teach with GitHub.
To have students complete assignments using forks (note: this setup means that students will be able to see one another's work):
Create one repository per assignment. Include any boilerplate files your students will need to get started.
If you'd prefer that your assignments or students' work isn't publicly visible, request private repositories to use for your class. You will need one private repository per assignment.
If your repositories are public, you can skip this step.
If your course materials are in private repositories, students will need read-only access to them. Create a
students team with "read access" and give that team access to all repositories that they will need. Next, add each student to the team, via
add_to_team in our teachers_pet tool, or manually.
Your students then follow these steps for each assignment:
You may consider making a context-specific copy of these steps in your syllabus or assignment description – grab the markdown.
Once created, you can then do code review with line-by-line feedback directly within the pull request. If you allow your students to submit corrections, they can push fixes up to their forks, which will be reflected in the pull request.
Since you don't want any solutions in the original assignment repository, you should leave the pull request unmerged. When you're finished giving feedback, you can close the pull request and leave a (
:+1:) in a final comment.