Athenian APCS Github Resources

Website

• The documents for the Athenian CS website are here
• The website is hosted here.
• After each push to the Github repo, the website is automatically rebuilt.

Classrooms

• Classrooms are created here.
• Each classroom is linked to a Github organization, which is where the student assignment repos will be created.
• Each classroom will have multiple assignments.
• Create a classroom for each section, every semester.

Assignments

• Assignment are created from a template repository in the APCS Organization.
• Assignment invitations will have a unique URL.

Creating an Assignment

1. Goto master-apcs-assignment-template and click on Use this template
2. Assign the repo a name (give it a -templatesuffix) and mark it as private.
3. Edit the new assignment repo as desired.
4. Goto the classroom page and select a classroom.
5. Click on New assignment
6. Click on Create an individual assignment
7. Assign a name and description to the assignment and mark it as private.
8. Under Add starter code enter the name of the template repo and select the matching repo name.
9. Select Enable automatic grading and add a Run Java test.
10. Click Create Assignment
11. Copy the new assignment invitation URL and add it to the assignment page.

Organizations

APCS Organization

• All repos are visible to the teachers and TAs
• Some repos are visible to students
• Repo visibility is controlled via Github Teams

Repos

1. A private APCS Administration Documents repo. Visible to Teachers and TAs.
2. A private APCS Content repo. Visible to All Students, Teachers and TAs.
3. A private master-apcs-assignment-template repo used to create assignment templates. Visible to Teachers and TAs.
4. A private template repo for each assignment. Visible to Teachers and TAs.

Assignment Template Repos

• Each student assignment in a classroom is automatically created using an assignment template repo.
• Assignment template repos are created using the master-apcs-assignment-template.
• Assignment template are marked as a template in the settings and each should have a -template suffix.

Teams

• All Athenian

  • Teachers
  • TAs
  • All Students

• A team will be created for each section at the beginning of the semester. Each section team will have All Students as a parent.

APCS Student Assignments Organization

• One organization for each semester.
• Naming should adhere to: apcs-assigments-semester, e.g., apcs-assignments-fall2020
• This is the organization to which each classroom is linked.
• Each student assignment repo will be created automatically when the student accepts an invitation.
• There will be one repo per assignment per student.
• Each repo will be private and visible to the student, teachers and TAs.

Actions

Actions to take at the beginning of each semester

1. Create a new Student Assignment organization using the proper naming convention.
2. Create a classroom for each Student Assignment organization.
3. Add the appropriate TAs and Admins to each classroom.
4. Create a classroom roster for each classroom
5. Add assignments to each classroom using the assignment templates in the APCS Organization.
6. Create a document in the class assignment repo that summarizes all assignment invitations. This document will be updated as the assignment list changes.
7. Create a team for each section under All Students.

Actions to take on the first day of class

1. Create github account for every student.
2. Give every student an assignment invitation URL.
3. When they respond to the assingment invitation, they will be asked to link their github ID with their class roster name.