Rubric Versioning
How Versioning Works
Semver system for rubric changes with I-O psychology terminology.
Every save of the interviewer or scorer rubric creates an immutable version snapshot.
Version Types (Semver with I-O Language)
| Type | Semver | When to Use | Example |
|---|---|---|---|
| Revision | Major (X.0.0) | Fundamental methodology change | Redesigning the scoring philosophy |
| Refinement | Minor (x.Y.0) | Moderate adjustment | Adding a new scoring rule |
| Calibration | Patch (x.y.Z) | Fine-tuning | Adjusting a threshold value |
Save Process
- Edit rubric fields in the admin UI
- Click "Save Changes"
- Modal appears requesting:
- Change type — Revision, Refinement, or Calibration
- Version name — descriptive label (e.g., "Adjusted ownership threshold")
- Description — at least 20 characters explaining the change
- Click "Save" → new version created, immediately active
Browsing History
- Click the version dropdown in the save bar
- SearchableSelect shows all versions with names and dates
- Click any version to preview its full configuration
- The current active version has a badge in the header
Rollback
- Select a previous version from the history
- Review its configuration in preview mode
- Click "Save" while previewing → creates a NEW version with the old config
- History is forward-only — rollback never overwrites previous versions
This design ensures a complete audit trail of every rubric state.