Skip to content

verify: document auto-run triggers#107

Open
davi-maciel wants to merge 1 commit into
mainfrom
davi/verify-auto-trigger-docs
Open

verify: document auto-run triggers#107
davi-maciel wants to merge 1 commit into
mainfrom
davi/verify-auto-trigger-docs

Conversation

@davi-maciel

Copy link
Copy Markdown
Contributor

Documents when Verify auto-runs, aligning the docs with the four intentional trigger moments (plus criteria-edit) shipped in mergeit #12922. Before this, the docs described the old per-push model and never explained when a run starts across a PR's life.

Changes

  • concepts/how-verification-works.md: new "When a run is triggered" section covering the auto-run moments (PR ready / approval / queued / PR linked / criteria edited), what doesn't trigger a run (plain pushes), manual runs, de-duplication, and deferred-until-baselines behavior. Corrected the run-start sentence so it no longer claims submission starts a run.
  • audit-trails-and-compliance.md, how-to-guides/export-audit-logs.md, reference/understanding-verification-results.md: updated trigger_source value lists to manual / ready / approval / queued / linked / criteria_edit.
  • reference/mcp-tools.md, your-first-spec.md: corrected claims that submitting or pushing auto-starts a run.
  • how-it-works.md: step 3 now links to the new section.

- Add "When a run is triggered" section to how-verification-works
- Update trigger_source enumerations in audit, export, and results pages
- Correct submit/push to run claims in mcp-tools and your-first-spec
- Link how-it-works step 3 to the new section
@davi-maciel davi-maciel force-pushed the davi/verify-auto-trigger-docs branch from d815628 to ae74df4 Compare June 30, 2026 21:19
@davi-maciel davi-maciel marked this pull request as ready for review June 30, 2026 21:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant