Download openspec/specs/grades/spec.md from wzender/mathly: direct link, hf CLI and curl.
- Browser
- Download file 1.72 kB
-
https://huggingface.co/spaces/wzender/mathly/resolve/main/openspec/specs/grades/spec.md
- Command line
-
hf download hf://spaces/wzender/mathly/openspec/specs/grades/spec.md
-
curl -L -o spec.md https://huggingface.co/spaces/wzender/mathly/resolve/main/openspec/specs/grades/spec.md
grades Specification
Purpose
One grade scale and one rule for timed attempts across quizzes, exercise tests, the simulation and assignments, and the screen where a student sees all their grades.
Requirements
Requirement: One grade scale
Every grade SHALL be a whole number from 0 to 100. In a multiple-choice quiz or test every question SHALL be worth the same, and the grade SHALL be the share of right answers, rounded.
Scenario: Seven of ten
- WHEN a student answers 7 of 10 questions correctly
- THEN the grade is 70
Scenario: Eight of twelve
- WHEN a student answers 8 of 12 questions correctly
- THEN the grade is 67
Requirement: When time ends
The simulation SHALL be the only timed attempt; a lesson quiz and an exercise test have no time limit. When the simulation's timer ends, the server SHALL submit it as it stands, and unanswered questions SHALL count as wrong. Closing or refreshing the app MUST NOT stop or reset the timer.
Scenario: Closed the app
- WHEN a student closes the app 5 minutes into a 15-minute simulation and opens it 20 minutes later
- THEN the simulation has been submitted with the answers given
Scenario: A quiz is not timed
- WHEN a student closes the app 5 minutes into a lesson quiz and opens it an hour later
- THEN the quiz is still open with the answers given
Requirement: Grades screen
The student SHALL have a grades screen listing every grade they have: each lesson's quiz (best grade), and every exercise test, simulation and assignment grade as those exist.
Scenario: After a quiz
- WHEN a student finishes a lesson's quiz
- THEN the grades screen shows that lesson's best quiz grade