Deviation Register is one of Understand's built-in reports — run it on your own code from the GUI, or headlessly with und report.
Deviation Register
Languages: AnyTargets: CodeCheck
A register of every suppressed violation, with its justification and approval record.
When a coding standard requires that deviations be justified, reviewed and approved, this is the document that shows it. Each suppression is listed with the check it silences, where it is, who wrote it, and the structured record it carries.
- Summary How many deviations exist, how many are fully documented, and which checks and files they cluster in.
- Register The full table — one row per suppression, one column per field found in the records, sortable and filterable.
- Gaps The deviations that are not defensible yet: no justification at all, or missing a field that comparable deviations record. This is the work list.
- By Check Where deviations concentrate, and how completely each check's deviations are documented.
- By Field Group the register by any field — Approved By, Severity, Owner — to review one owner's deviations at a time.
Deviations get their records from annotation templates offered in the Ignore Violation dialog, and read the same whether the suppression was stored as a comment in the code or as an annotation in the project. A suppression written without a template still appears here, counted as undocumented.
The Summary heads with the Deviation Completeness chart: the whole inspection split into what nobody deviated from, what is deviated from and defensible, and what is deviated from but not yet documented.