Reports what changed between two snapshots (or between a snapshot and the project's current grading state): rubric items added, removed, reworded, re-pointed or regrouped, groups added, removed, renamed or re-bounded, scoring changes; per-repository selection, public comment and private note changes; per-pair score deltas and every repository's total before and after; and template questions added, removed, renamed or changed.
Usage
snapshot_diff(
from,
to = "current",
project = ".",
part = c("rubric", "marks", "template")
)Arguments
- from
A snapshot reference (see
snapshot_info()).- to
A snapshot reference, or
"current"(the default) for the live state.- project
Path to the project directory. Defaults to the working directory.
- part
Which parts to compare: any of
"rubric","marks","template". Scores are always compared.
Value
A markermd_snapshot_diff object. Its rubric, marks,
scores, totals and template properties are data frames.
Details
Rubric items and groups are matched across the two sides by the database
ids a snapshot records, so an item reworded or a group relabeled in
mark() is reported as a rename. A replace import mints new ids; items it
re-created are matched as a likely rename when they keep their points and
are selected by the same repositories on both sides. Selections are
compared by item id as well, so a reworded item is not a selection change
while a deleted item whose description another item took over still is.
Questions are matched by the ids of the two sides' templates, so a question
renamed in between is compared with itself under its newer name, and only
the template comparison reports the rename.
The comparison is only meaningful when the snapshot's part is present on
both sides; a part left out is reported as unchanged.