- How to Form Groups
- Download Starter Files
- Submitting Work for an Assessment
- View Results
- Submit a Remark Request
- Timed Assessments
- Email Settings
- Key Pairs
After navigating to the appropriate assignment, click the Create Group button to create your group:
You may then choose to invite other group members using the "Invite Student(s)" button:
If a student is not eligible to be a part of your group, you will receive a warning:
Once you have invited someone, they will appear under the "Group invitations" list but will have a pending status until they accept the invitations. Invitations can be accepted by clicking the "Join Group" button or declined by clicking the "Decline Invitation" button.
Once a group meets the minimum member requirements for the assignment, you will be allowed to submit files for the assignment.
⚠️ WARNING When adding other students to a group, the inviter must type in their teammate's exact username (case sensitive) not their first/last name.
If starter files have been provided for an assignment, they will be available when on the Assignment page.
You can download the starter files by clicking the "Download" file in the "Starter Files" section of the Assignment page:
If your instructor has changed the starter files since the last time you downloaded it, you may see a warning at the top of the page:
If you see this warning message you may want to download the new copy of the starter files.
To submit work for an assessment, first select the assignment from the table on the Home page.
Navigate to the Submissions page by clicking the "Submissions" tab. From this page, you should be able to upload and download files using the file manager.
You can also view a preview of the files you have already submitted by selecting the file on the file manager table.
If you are missing some required files, a list of missing required files will be included as a warning at the top of the page.
If you have uploaded one file to submit, you will have the option to rename it.
- If you can only submit the files the instructor has requested for, you can rename your file from a drop down menu.
- If you can submit any file you want but the instructor has requested some files, you can rename your file using a textbox with a dropdown.
- If you can submit any file you want and the instructor has not requested any, you can rename your file using a textbox.
If your instructor has enable submission through version control you will see a section called "Group repository URL" on the Assignment page. You may use this url to clone your repository for the given assignment.
The repository will have the following structure:
group_name/
├── markus-hooks/
│ └── ...
├── assignment1/
│ └── some_file.txt
└── assignment_other/
└── other_file.py
Where:
group_nameis the name of your group for this assignemnt.markus-hooksis a directory containing git hooks used by MarkUs, do not modify this directory or its content.- all other directories are named after assignments available to your group. In this case, the assignments are named
assignment1andassignment_other.
⚠️ Warning: You may only add/remove/modify files in the assignment subdirectories. Any commits that contain changes to any other file will be rejected by MarkUs when pushed.
▶️ EXAMPLE: To submit a file toassignment_other, create a file in theassignment_other/subdirectory and push the changes back to MarkUs.
When you push your changes to MarkUs using git, MarkUs may reject your changes if one of the following is true:
- you have created, modified, or deleted a file or directory that is not in one of the assignment directories
- you have force pushed your changes
- you have submitted a file that is not required and only required files are allowed to be submitted for your assignment
- you have submitted a file that is too big
If you want to be warned early if any of your changes will be rejected by MarkUs you can set up client-side hooks. These hooks will warn you if any of your changes will be rejected by MarkUs when you commit your changes. That way you will have a chance to correct the issue before you push your changes to MarkUs.
To enable client-side hooks, copy the contents of the markus-hooks directory to the .git/hooks directory.
Once your submssion for an assignment has been marked, the Result tab will become visible for your assignment. Click this tab to show the detailed results for this assignment. On this page you can:
- See the files you submitted from the "Submissions files" tab.
- If annotations have been left by graders, these will be visible by hovering over highlighted sections of the submitted files.
- See a list of all annotations from the "Annotations" tab
- Submit a remark request (if available) from the "Remark Request" tab.
- See your mark for this assignment broken down by criteria from the "Marks" tab.
- See a summary of your marks (including any bonuses or deductions) as well as any notes or overall comments on the "Summary" tab.
- View and download feedback files in the "Feedback File" tab.
- To download a specific feedback file, you can click on the "Download" button next to the feedback file dropdown. This downloads the feedback file you are currently viewing.
If your instructor chooses, you may need a "release token" to view your results. A release token is a series of random numbers and letters that is unique to your result.
If a release token is required, you can request one from your instructor once they have finished grading your assignment. When you go to the Result tab you will be asked to enter your release token to view the Result page.
If your instructor has enabled remark requests for your assignment and the deadline to submit remark requests has not yet passed, you can submit a remark request from the "Remark Request" tab on the Results page.
Start by writing a message in the text box explaining why you are submitting the request. You may save your message at any time and come back to it later.
When you are ready to submit the request click the "Send" button. The remark request will now be visible to your instructor and any graders. Once the instructor has had a chance to review your request they may respond. Their response will be visible on the "Remark Request" tab and changes to your marks (if any) will be visible from on the "Marks" tab.
You may cancel a remark request at any time from the "Remark Request" tab.
Timed assessments differ from regular assignments in that they do not have a fixed due date before which you must complete the assignment. Instead the instructor specifies a range of times between which the you must start the assignment. After you have started the assignment, you will have a fixed number amount of time to finish the assignment.
Before you can start the timed assessment you can still see the assignment details and create a group. On the main Assignment page you will see a "Timed Assessment" section which will tell you when you can start the assessment and how long you will have once you start. If you have been given an extension, it will be visible here as well.
Once you can start the timed assessment a "Start" button will become visible. Click this button to start the assessment. Once you click the "Start" button you will must complete and submit your work to MarkUs before the duration expires.
In the example below, a student will have exactly 3 and a half hours to complete and submit the assessment once they have clicked the "Start" button.
Once you have started the assessment, the "Submissions" tab will become visible and you will be able to submit your work as normal.
You will also be able to see how much time you have left to submit:
If you wish to receive emails when the results of an asessment are released and/or if you are invited to a group, navigate to the "Settings" tab and enable either of these options. To enable one of the options, select one or both of the checkboxes and click "Update Settings".
If your instance of MarkUs is using git repositories to store student submissions, you have the option to upload a public key to MarkUs. This public key will be used to authenticate you when you clone a git repository from MarkUs over ssh.
To upload a public key, navigate to the "Key Pair" tab. Click on the "New Key Pair" link to upload a new key pair (as a file or as text) or click on an existing Key Pair to edit it. You may upload multiple public keys in this way.
For instructions on how to generate a public/private key pair see: