Beta release. Both the application and this documentation are still under development and their content will be revised as the work continues.
This part of the documentation describes how a teacher creates a course, prepares exercises, assigns them to students, grades the solutions that come in and runs an examination.
The system works with four concepts, and every other setting is a detail of one of them.
The distinction between an exercise and an assignment is the one that matters: an exercise is written once and assigned many times. Editing it later does not affect the courses it is already assigned in until you trigger the synchronisation yourself.
A course is created in the Groups section. A name in at least one interface language (Czech or English) is required; the other can be added later.
Three kinds of group govern how a course behaves:
Independently of its kind, a group can be marked public, which means students may enrol themselves without the teacher's involvement.
Once a term or an academic year ends, inactive groups can be archived. An archived group can still be returned to, but it disappears from the list of active courses for students and teachers alike.
Students can be brought into a course in three ways: they enrol themselves where the course is public; you add them by hand from the list of users; or you send them an invitation link with a limited validity. The links are managed in the course detail, and each shows who issued it and how long it remains valid.
The course settings further determine whether students may leave the group on their own, and whether they see the group's aggregate statistics.
A new exercise is created in the Exercises section. Before it can be assigned its configuration has to be complete; until it is, the system marks it as incomplete and states the particular reason — a missing text, no tests, no method of computing the score, no programming language selected, an incomplete test configuration or invalid limits.
$...$ and
$$...$$ are rendered.Submit the reference solution and read its result before giving the exercise to students. If it does not earn full marks, the exercise is not ready — every student would meet the same obstacle.
Not every piece of work can be run and tested. For essays, measured data, presentations or scanned documents there is the Data-Only environment, chosen among the exercise's programming languages in the Languages section. It accepts any file regardless of its extension, compiles and runs nothing, and has neither tests nor limits — the exercise configuration is therefore reduced to the text of the task itself.
The submitted solution is given the state Awaiting grading and no points. You award the points by hand on the solution screen; only then is the solution considered graded. Until you do, the system asserts no verdict to the student.
Data-Only cannot be combined with any programming language in the same exercise; the interface says so.
An assignment containing an autograding.json file can be imported instead of being retyped. Tests
of type input and output are converted into tests in the system, the template's README.md
becomes the text of the exercise and the remaining files become attachments.
What cannot be converted, the import states explicitly: neither a test that runs an arbitrary shell command nor an entire testing framework inside the repository can be reduced to input/output pairs. A Classroom template also practically never contains a reference solution, so one has to be added.
In the course detail, choose to assign an exercise. The selection begins with your course's own exercises and can be widened to the whole catalogue.
You then set the terms:
Deadlines are entered in your own time zone and displayed to every user in theirs.
If you edit an exercise after it has been assigned, the change does not reach the existing assignments by itself. An assignment holds its own copy of the configuration, and its synchronisation with the exercise has to be triggered.
The Solutions tab of an assignment lists the individual attempts, one row per submission. Opening a particular solution shows the submitted files, the result of every test and how the solution's score in points was arrived at. Of one student's submitted solutions exactly one is chosen, and its points are the ones that count towards the overall grade.
From the solution screen you can do the following:
Without any intervention from the teacher, the solution counted towards the grade is the one with the most points, not the most recent. Where two are equal on points, the newer attempt wins. If you accept a solution, it takes precedence over both rules.
Students may request a review themselves. The requests collect on your dashboard, so the queue of open reviews is a place you look at rather than something you have to remember.
The Students tab presents a matrix of points: every student against every assignment, with totals. The matrix can be exported, and every cell links to that student's attempts.
Each student additionally has a screen of their own within the course, with everything they have submitted in one place. It is usually the quickest answer to the question of how a particular person is getting on.
A shadow assignment records points for work students do not submit to the system — a presentation, an oral examination or participation in a seminar. It appears in the course's scoring beside ordinary assignments, and you enter the points yourself, student by student, together with the date on which they were earned.
The deadline of a shadow assignment is informative only: the system enforces nothing by it, and whether it was met is for you to decide.
A course can be switched into examination mode for a chosen period. The examination begins immediately or at a time you set, lasts for a given duration or until a given end, and may lock students into the course for that time. A locked student sees only that course for the duration, and invitation links to other groups are refused meanwhile.
Set the examination mode up before the room fills. The Exams tab shows the progress, the list of locked students and the records of examinations held earlier; individual students can be released where necessary.