Getting Started

1. Create Assignment#

The first step in creating a new assignment is navigating to the desired section for the assignment. Once on the section view a new assignment can be created through the "Add Assignment" button on the section view (picture below).

Create Assignment

The Assignment Creation modal flow will first require you to select one of 3 assignment creation modes (Brand New, Redeploy, or Fork - described in greater detail below) and then possibly ask for further information such as assignment name and assignment code.

  1. Brand New: The Brand New mode will start a new assignment from scratch with new, clean repositories and default configuration. Use this mode if you are creating an assignment you have not deployed to AG350 before or are transitioning a new assignment from another platform.
  2. Fork: The Fork mode will allow you to copy the tests and configurations from a previously written assignment to a new "forked" assignment. The new assignment will clone the tests, solution, and starter kit, from the other assignment. However, the new, "forked" assignment will get its own repositories and will be maintained separately from the assignment from which it was cloned. Use this option if you are deploying an assignment that you have used in other sections or previous terms.
  3. Redeploy: Like Fork, the Redeploy mode will clone the tests and configurations from a previously written assignment, but the original and new assignment will share the same underlying repositories. Therefore, any changes to the assignment of one section will affect any "redeployed" assignments in another. In most cases we suggest opting for the Fork option over redeploy.
Create Assignment

2. Configure Assignment#

Configure Assignment

Once the assignment is created you can configure the assignment by clicking the "Configure" button on the assignment page. This will navigate you to an assignment configuration page where you can alter settings such as due date, late policy, starter kit, solution code, as well as the tests for the assignment. Don't worry, a checklist will help walk you through all of the steps and you don't need to make a decision on these settings now - you can always skip them for now and come back!

3. Upload Starter Kit / Solution#

An assignment has 3 repositories that are integral to its configuration:

  1. Starter Kit: The Starter Kit provides the code that students receive when they start the assignment.
  2. Solution: As the name suggests, this repository hosts the solution for the assignment.
  3. Tests: This repository is for creating tests for the assignment.

To update the starter kit or solution code for the assignment:

  1. Push the code to the branch of your choosing to the respective repo using git.
  2. Navigate to the starter kit or solution tab on the Configuration page.
  3. Select your branch on the left hand side of the screen (see below).
  4. If you're uploading start kit code "link" in the right version. If you're uploading solution code, select the right version on the left and then link (see below)

Starter Kit:

Starter Kit

Solution:

Solution

At this time you should upload a starter kit and solution. Too soon? Don't worry you can always skip and come back to it or upload what you have and link in something different later!

4. Write Tests#

Woo, now you're ready to write some tests! Continue on to Writing Tests for our docs on how write tests in AG350.