feat(exam_pack): rich per-option Gradescope grading note + TF/code answer normalization - #26
Open
agiacalone wants to merge 1 commit into
Open
feat(exam_pack): rich per-option Gradescope grading note + TF/code answer normalization#26agiacalone wants to merge 1 commit into
agiacalone wants to merge 1 commit into
Conversation
…swer normalization
The build's GRADING_NOTE.md only carried the answer letter, emitting a stripped
| Q | Name | Answer | Rubric | summary that couldn't drive per-option ISA grading
or round-trip to reg-gradescope-stats (the form·Qn·slot keys). Closes the tracked
"Known gap"; every exam built since (Exam 2, Final) had the broken note.
- parse_outline_from_tex extracts each option's text + correctness from the .tex
(\correctchoice/\wrongchoice, balanced-brace aware) via a _detex LaTeX->text pass.
- emit_grading_note renders the canonical rich form: "#### <Form>.Q<n>" headings,
per-option | Pts | Key | Rubric item | tables keyed <form>.Q<n>.<slot>, no-answer
rows, FIB per-blank rows, *Scoring:* captions, and a reg-gradescope-stats link.
- Legacy inline \textsc{T/F} code items (no enumerate) synthesize True/False rows
from the answer so keys still round-trip.
- TF/code outline answers normalized to the verdict word True/False (never a
letter) regardless of reveal style; docs reconciled to the bare-word house
standard + defensive normalization.
Regenerated CECS 378 Su26 Exam 2 + Final grading notes; answers cross-checked
against _outline.csv. Tests: 407 passed (3 new).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E6bNoTCzWuc8zbyShHVKFB
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What & why
reg-exam-build'sGRADING_NOTE.mdonly carried the answer letter, so it emitted a stripped| Q | Name | Answer | Rubric |summary. That can't drive per-option ISA grading, and it lacks theform·Qn·slotkeysreg-gradescope-statsjoins against for per-distractor item analysis. This was a tracked "Known gap" in the CHANGELOG; every exam built since regressed to it (Su26 Exam 2 and the Final).Changes
parse_outline_from_texextracts each option's text + correctness from the.tex(\correctchoice/\wrongchoice, balanced-brace aware) via a_detexLaTeX→plaintext pass.emit_grading_noterenders the canonical rich form (matching Exam 1):#### <Form>·Q<n> · name · pts · TYPEheadings, per-option| Pts | Key | Rubric item |tables keyed<form>·Q<n>·<slot>, "No answer / multiple marks" rows, FIB per-blank rows,*Scoring:*captions on fib/code, and a<!-- reg-gradescope-stats:link -->Post-exam-statistics section.\textsc{T/F}code items (no\correctchoiceenumerate) synthesize their True/False rows from the answer, so keys still round-trip.True/False(never a letter), regardless of whether the reveal readsAnswer: Trueor a deviatingAnswer: a (True). Docs reconciled to the bare-word house standard + the defensive normalization (docs/design/exam-tex-format.md).Verification
_outline.csv(0 real mismatches).🤖 Generated with Claude Code