All docs

Grading and the gradebook

Where scores come from, how to grade a student's work, grading by hand, and how the gradebook averages.

Published by Birdflop, a 501(c)(3) nonprofit · Last updated

Where scores come from

A test score is the passed/total from a graded run of an assignment's tests. Graded runs happen when:

  • A student submits. Their submission is graded right away.
  • You click Regrade all on an assignment's Student work tab, for every student, or Run all tests on the class's Gradebook tab, for every assignment and every student. The run happens in the background and shows its progress. Students it could not grade are listed with a Retry button.
  • The assignment closes: at the due date (or at the end of the late window, see Late work in Creating an assignment), or when you click Close now. Everyone who has not submitted has their work collected, and CS Room grades everyone. Submissions are final from then on, so a grade changes only when you fix the tests and click Regrade all. A score you typed in by hand never changes.
  • A student's extension runs out. Their work is collected and graded then.

Work a student has not submitted yet shows in gray. It is how their tests score on their current files, kept up to date every couple of minutes while you have the page open. A gray score is not a grade, and averages leave it out until the student submits or the assignment closes.

If a run fails for a reason that is not the student's code, such as the server being busy, CS Room tries again. If it still fails, the cell shows a red mark with the reason, and the student keeps the score they had.

Students check their own work with the Run Tests button in their workspace, which appears once the assignment has visible tests. It runs only those and records nothing.

Grading a student's work

An assignment's Student work tab lists every student with their submission time, score and Mark reviewed. Click a student to grade their work. The grading page is their workspace with grading beside it:

  • Submitted or Live workspace, at the top. Submitted is the copy they turned in, read-only, and opens first when there is one. Live workspace is their workspace as it is now, the same editor, terminal and preview you get in your own: you see their typing as it happens, what you type lands in their file, and you can run their program.
  • Comments on lines in either one. Click a line number to comment on that line. To comment on several lines, drag across the line numbers, or click one and shift-click another. Comments appear under the lines they are about, like a code review.
  • The grading panel on the right: their running site, the score with Set score, the tests case by case with a button to run them again, an overall comment, the student's Extension, Mark reviewed, and Show grade or Hide grade.
  • Previous and next at the top, or the [ and ] keys, to move through the class.
  • Download, at the top, saves the student's submission as a zip. The download icon at the top of an assignment saves the assignment and every submission in one zip, a folder per student, and the one beside the class's name saves all of its assignments.

Students see your comments on their assignment page and beside their own code in the workspace, with new ones marked, and can reply to them. See Questions and notifications.

A student's running site

If the student is running a web app, such as a Flask site or a page served with python -m http.server, the grading page lists its address under Running site, to open or copy. Only servers the student starts from inside this assignment's folder are listed. A server they run from anywhere else, such as a personal project, stays private to them.

Opening a student's workspace

Open student's workspace on the People tab opens their whole class folder, every assignment, in the same editor, with a banner saying whose workspace you are in. Exit returns to the class page.

A student who breaks a starter file can get it back. They right-click the file in their workspace and choose Restore, or right-click the assignment folder and choose Restore all files to bring back one they deleted.

Showing and hiding grades

On a new assignment, each grade stays hidden from the student until you show it. Before that, they see only their test results.

  • Show grades, beside Regrade all on the Student work tab, shows every hidden grade at once.
  • Show on a student's row, or Show grade in the grading panel, shows one student's.

The student gets a notification. Once a grade is shown, they see any change to it, such as a regrade or a score you set.

To hide a grade again, click Shown on the student's row, or Hide grade in the grading panel. Hide grades hides every shown grade at once.

To show every grade as soon as it is scored, set Students see their grade to Immediately on the assignment's Settings tab. The Show and Hide buttons only appear on assignments set to When shown.

An assignment with no tests shows students no test score at all.

Grading by hand

Projects and anything tests can't check are graded by hand. On an assignment's Settings tab, Graded by has three choices:

  • Tests: the test score is the grade.
  • Manual: you give each student points out of the Total points you set.
  • Tests + manual: the tests are worth some points and you add the rest. With tests worth 80 and 20 manual points, a student who passes 3 of 4 tests and gets 15 manual points has 60 + 15 = 75 out of 100.

Enter points on the grading page or by clicking the student's cell in the gradebook. A grade with a manual part counts once you have entered the points. On a Manual assignment the due date only closes it; no tests run.

The Gradebook tab

The Gradebook tab lists every student down the side and every assignment across the top, with an Average column at the end. Each cell shows the student's grade, a gray score for work not submitted yet, or a dash. A cell reads Not assigned when the assignment is shown to only some students and this student isn't one of them (see Shown to in Creating an assignment). It is left out of their average and blank in the CSV.

The selector at the top sets how the average weighs assignments. The download icon exports the grid as CSV, with an earned and a possible column for each assignment plus the average.

Setting a score

Click a score to see its details. Set score lets you type a different score. It can go above the total, for extra credit, and it stands until you click Clear score; later test runs still record results, but the grade keeps your score. A score you set shows with a dotted underline. It never stops the student from submitting.

The lock in an assignment's column header shows whether it is closed. Clicking it is the same as Close now or Reopen on the assignment's Settings tab. Reopening keeps the scores you set.

Set scores apply to the test score. Manual points are yours to change at any time.

How the average works

Equal weights

Every assignment counts the same. The average is the mean of each grade as a percentage. An assignment a student has no grade on yet is left out of their average. A locked score always counts, including a locked zero.

Custom weights

Set a weight for each assignment in the Weights row. An assignment weighted 200 counts twice as much as one weighted 100.

Switching to this mode gives every assignment without a weight a weight of 100. An assignment with no weight drops out of the average, and one you publish after setting your weights has none, so check the row after adding one.

Switching back to equal weights keeps your custom weights for when you switch back.