Skip to main content

Find what started failing since the last scan

A repository's gap list mixes old debt with fresh breakage. When a recent change breaks a rule the repository used to pass, you usually want to fix that one first, while the change is still fresh. Each gap says how long it has failed and marks the ones that passed on the scan before. This guide rescans a project and picks out those gaps. How scans, rules and levels work is in How compliance works.

Who can do this: anyone who can open Compliance can read the gaps. Running a new scan and fixing need the permission to edit compliance; fixing also needs permission to create and edit tasks on the project.

  1. In the sidebar, select Compliance. The list shows one row per project, with its Level, Gaps and Next gap.

  2. Select the project's name. Its page opens on the Overview tab.

  3. To compare against the newest code, select Rescan in the header and wait until the scan finishes. The line under the header shows the Commit scanned and when it was Scanned.

  4. Find Gaps on the Overview tab. Each gap shows its rule's name, then a short line with its level, its mode and how long it has failed, such as L1 · Advise · 34d. A gap that failed for the first time today reads today.

    One gap: the rule's name, then L1, Advise and 34d, why the rule matters, what was found, Fix and the more menu

  5. Look for ↓ at the end of that line. It marks a rule the repository passed on the scan before and fails now; hover it to read Worse than last scan. Hover the age to read Failing since and the date.

  6. For each new gap, read what the scan found under it, or select ⋯ and then Evidence for the full record of what was checked.

  7. Select Fix on the gap. Jaah files a task that fixes it, and the gap follows the fix to its pull request, as in Fix a repository's compliance gaps.

  8. Once the fix has merged, select Rescan again. The gap leaves the list when the rule passes.

A gap with a short age but no ↓ has failed on more than one scan in a row. If the change that broke a rule was deliberate, waive the gap for a set time instead of fixing it.