Skip to main content

Waive a compliance gap

Some gaps can't be fixed yet. A waiver accepts one failing rule on one repository until a date you choose. It is debt: someone owns it, something covers the risk meanwhile, and once it lapses the gap fails again.

Who can do this: anyone with the permission to edit compliance on the project. Without it, a gap's ⋯ offers no Waive. A rule in Lock mode can't be waived, and neither can a rule that allows no waiver: its evidence page says "This rule cannot be waived."

Waive a gap​

  1. In the sidebar, select Compliance. On the Repos tab, select the project's name to open its page.
  2. On the Overview tab, find the gap under Gaps (N). Select ⋯ at the end of its row, then Waive. The rule's evidence page opens at its Waive section.
  3. In Owner, keep yourself or search for the person who owes this debt. Only enabled accounts are offered.
  4. In Expires, pick the day the waiver lapses: from tomorrow up to the limit shown under the field, such as Up to 180 days.
  5. In Compensating control, say what limits the risk while the rule fails.
  6. In Reason, say why the gap is accepted for now.
  7. Select Waive. It stays off until every field is filled; Discard clears them.
  8. Check the section: it now reads Waived until and the date.

The gap leaves Gaps and the rule reads Waived until … on the repo's Rules tab.

Revoke a waiver​

  1. Open the project's page and select the Rules tab.
  2. Select the Waived filter. Each open waiver shows its rule, owner, expiry, reason and control.
  3. Select ⋯ at the end of the waiver's row, then Revoke.
  4. In Revoke waiver?, select Revoke. The rule counts against the repository again.

You can also revoke from the All filter: a waived rule's ⋯ holds Revoke waiver.

Where waivers fit among fixes and campaigns is in How compliance works. To fix the gap instead, see Run a compliance scan. Every waiver field is in the Repository compliance reference.