Skip to content

Commit fe26383

Browse files
authored
docs(mq): document skip_intermediate_results (#9393)
This adds a paragraph in the parallel checks page. Fixes MRGFY-6085
1 parent a7179ea commit fe26383

File tree

1 file changed

+23
-0
lines changed

1 file changed

+23
-0
lines changed

src/content/docs/merge-queue/parallel-checks.mdx

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -131,6 +131,29 @@ Parallel Checks adapt automatically as your code and rules evolve:
131131
`reset_on_external_merge` — see [Lifecycle: Base Branch
132132
Updates](/merge-queue/lifecycle#base-branch-updates).
133133

134+
### Skip Intermediate Results
135+
136+
By default, each speculative draft that includes a pull request must pass
137+
before that pull request can be merged. When
138+
`merge_queue.skip_intermediate_results` is enabled, Mergify can merge a pull
139+
request as soon as a later downstream draft that also includes that PR passes,
140+
even if earlier intermediate drafts failed.
141+
142+
When to use it:
143+
144+
- Your CI is stable (low flakiness) and long-running, and you want to reduce
145+
latency by trusting the first comprehensive passing draft.
146+
147+
- You're using parallel checks and/or batches and care more about the final
148+
combined outcome than each incremental step.
149+
150+
Enable it in your configuration:
151+
152+
```yaml
153+
merge_queue:
154+
skip_intermediate_results: true
155+
```
156+
134157
## Important Considerations
135158

136159
### In‑place checks (no drafts)

0 commit comments

Comments
 (0)