merge queue: embarking main (6f00667), #11048, #10944, #11050 and #11051 together

src/content/docs/migrate/bulldozer.mdx

@@ -1,30 +1,31 @@
 ---
 title: Migrate from Bulldozer to Mergify
-description: Map Bulldozer configuration and behaviors to Mergify rules and merge queue.
+description: Move from Bulldozer automerge to Mergify's Merge Queue for safer, faster merges.
 ---
 
 [Bulldozer](https://github.com/palantir/bulldozer) focuses on automerging pull
-requests based on labels, reviews, and status checks. Mergify covers that and
-more, with a powerful rule engine and a production‑grade merge queue.
+requests based on labels, reviews, and status checks. Mergify's [Merge
+Queue](/merge-queue) covers that and more, with automatic PR updates,
+prioritization, batching, and parallel checks.
 
-This page shows a practical, minimal‑diff path to move from Bulldozer to
-Mergify.
+This page shows a practical path to move from Bulldozer to Mergify's Merge
+Queue.
 
 :::tip[Need help?]
 
-We’ve migrated many teams from Bulldozer. [Reach
-out](mailto:support@mergify.com) and we’ll review your Bulldozer configuration
+We've migrated many teams from Bulldozer. [Reach
+out](mailto:support@mergify.com) and we'll review your Bulldozer configuration
 and propose an equivalent Mergify setup.
 
 :::
 
 ## Typical Migration Plan
 
-1. Keep your labels and branch protections as‑is
-2. Translate Bulldozer settings to one or two Mergify rules
-3. Start with a dry‑run or low‑impact setup and expand gradually
+1. Keep your labels and branch protections as-is
+2. Set up a Mergify merge queue with conditions matching your Bulldozer config
+3. Start with a low-impact setup and expand gradually
 
-## Common Bulldozer config → Mergify
+## Common Bulldozer config → Mergify Merge Queue
 
 Example Bulldozer snippet:
 
@@ -38,59 +39,49 @@ merge:
     - "ci/circleci: ete-tests"
 ```
 
-Equivalent Mergify:
+Equivalent Mergify merge queue:
 
 ```yaml title=.mergify.yml
-pull_request_rules:
-  - name: Automerge when ready
-    conditions:
+queue_rules:
+  - name: default
+    merge_method: squash
+    autoqueue: true
+    queue_conditions:
+      - base = main
       - label = merge when ready
       - head ~= ^feature/
       - "check-success = ci/circleci: ete-tests"
-    actions:
-      merge:
-        method: squash
 ```
 
 Notes:
 - Checks map to `check-success = <name>` (or `check-skipped`, `check-neutral`)
 - Required labels map to `label = <name>` conditions
 - Approvals map to review count or specific reviewers
+- The merge queue keeps PRs updated automatically — no manual rebases needed
 
-## Enabling the Merge Queue (optional but recommended)
-
-If you rely on Bulldozer plus manual rebases to keep PRs up‑to‑date, [Mergify’s
-Merge Queue](/merge-queue) removes that toil — with even more optimizations.
+## Going Further with Merge Queue
 
-Add a queue rule and switch to queueing instead of immediate merge:
+Once you have basic automerge working, you can take advantage of features
+Bulldozer doesn't offer:
 
-```yaml title=.mergify.yml
-queue_rules:
-  - name: default
-    autoqueue: true
-    queue_conditions:
-      - base = main
-      - check-success = ci
-```
+- [Priorities](/merge-queue/priority) — urgent PRs jump ahead in the queue
 
-- The queue keeps PRs updated and merges them only after passing on the latest
-  version of the base branch
+- [Batches](/merge-queue/batches) — merge multiple PRs at once to reduce CI
+  load
 
-- You can set [priorities](/merge-queue/priority),
-  [batches](/merge-queue/batches), and [parallel
-  checks](/merge-queue/parallel-checks) later
+- [Parallel checks](/merge-queue/parallel-checks) — test multiple queue
+  entries simultaneously
 
 ## Feature parity quick table
 
-- Merge methods: squash/merge/rebase → supported
+- Merge methods: squash/merge/rebase → supported via `merge_method`
 
-- Delete branch after merge → [`delete_head_branch`
-  action](/workflow/actions/delete_head_branch)
+- Delete branch after merge → use GitHub's "Automatically delete head branches"
+  repository setting
 
-- Rebase/update before merge →
-  [`rebase`](/workflow/actions/rebase)/[`update`](/workflow/actions/update)
-  actions or merge queue `update_method`
+- Rebase/update before merge → automatic in merge queue
 
-- Require labels → conditions `label = `
+- Require labels → `label =` in `queue_conditions`
 
-- Restrict by authors/paths → conditions `author =`, `files ~=`, etc.
+- Restrict by authors/paths → `author =`, `files ~=`, etc. in
+  `queue_conditions`

src/content/docs/workflow.mdx

@@ -1,90 +1,30 @@
 ---
-title: Introducing Mergify Workflow Automation
-description: An overview of Mergify Workflow Automation and its capabilities to supercharge your pull request process.
+title: Workflow Automation
+description: An overview of Mergify Workflow Automation and its capabilities to automate your pull request process.
 ---
 
-Mergify Workflow Automation is a sophisticated system designed to revolutionize
-your pull request process. It empowers development teams to automate tasks and
-processes using a rule-based approach. This ensures efficiency, consistency,
-and adherence to project standards.
+Mergify Workflow Automation is a rule-based system that automates pull request
+tasks using `pull_request_rules` in your Mergify configuration file.
 
-## Why Use Mergify Workflow Automation?
-
-1. **Automate Repetitive Tasks**: Frequent tasks such as labeling, assigning,
-   or merging pull requests can be automated, freeing up developers to focus on
-   code and innovative solutions.
-
-2. **Consistent Standards**: Ensure that each pull request adheres to your
-   project's guidelines, with automated checks and balances in place.
-
-3. **Flexible and Powerful**: The system is based on rules that you define,
-   offering flexibility to cater to your project's unique needs.
-
-4. **Real-time Feedback**: Instantly inform contributors about the status of
-   their pull requests, ensuring clarity and quick response times.
-
-5. **Easier On-boarding**: Make it easy for any developer to understand your
-   repository rules by crafting your rules in an easy-to-read YAML format.
-
-## State-Based, Edge-Triggered System
+## How It Works
 
 Mergify evaluates the state of a pull request rather than individual events.
-
 This means it checks the current status of a pull request and acts based on
 defined conditions. This behavior is known as "edge triggering."
 
-An action will only by re-triggered for a pull request if the state flips back
+An action will only be re-triggered for a pull request if the state flips back
 from being unmatched to matched.
 
-For instance, consider a rule that specifies a pull request should be merged if
-it has at least two approved reviews and all CI checks pass. Even if the second
-approval and CI success come at different times, Mergify will act once the
-entire state of the pull request matches the rule.
-
-```yaml
-pull_request_rules:
-  - name: merge automatically when CI passes and PR is approved
-    conditions:
-      - "#approved-reviews-by >= 2"
-      - check-success = my-favorite-ci
-    actions:
-      merge:
-```
-
-On the other hand, a rule that posts a comment when a pull request is in
-conflict with its base branch will only be triggered when the pull request
-becomes in conflict, or when it becomes in conflict again — not every push to
-its base branch.
-
-```yaml
-pull_request_rules:
-  - name: merge automatically when CI passes and PR is approved
-    conditions:
-      - conflict
-    actions:
-      comment:
-        message: Your PR is in conflict, {{author}}. You should fix it.
-```
-
-This makes sure the system does not *spam* the pull request.
-
 :::note
-Mergify never evaluates rules for pull request drafts it creates to
+  Mergify never evaluates rules for pull request drafts it creates while
   processing the [merge queue](/merge-queue).
 :::
 
-## Getting Started
+## Reference
 
-To begin with Mergify, you'll need to [setup Mergify on your GitHub
-repository](/integrations/github). You can then [set up rules for your
-repository](writing-your-first-rule).
+- [Rule Syntax](/workflow/rule-syntax) for the `pull_request_rules` format
 
-Each rule will contain conditions (e.g., pull request state, number of reviews)
-and actions (e.g., merge, label). When a pull request meets the conditions of a
-rule, the specified actions are automatically executed.
+- [Actions](/workflow/actions) for the full list of available actions
 
-Mergify Workflow Automation is more than just a tool – it's a game changer for
-developers and teams who seek efficiency, consistency, and automation in their
-pull request process. By introducing state-based, edge-triggered rules, Mergify
-provides unparalleled control over your project's workflows. Dive in, set up
-your first rule, and experience the transformation firsthand.
+- [Configuration File](/configuration/file-format) for the overall config
+  structure

src/content/docs/workflow/actions/dismiss_reviews.mdx

@@ -3,7 +3,6 @@ title: Dismiss Reviews
 description: Dismiss previous reviews on a pull request.
 ---
 
-import Button from '../../../../components/Button.astro';
 import ActionOptionsTable from '../../../../components/Tables/ActionOptionsTable';
 
 The `dismiss_reviews` action allows Mergify to automatically dismiss approved
@@ -14,9 +13,3 @@ reviews in your pull request workflow.
 ## Parameters
 
 <ActionOptionsTable def="DismissReviewsActionModel" />
-
-## Examples
-
-<Button colorScheme='teal' href="/workflow/dismiss-reviews">
-  Read Dismiss Reviews Use Case
-</Button>

src/content/docs/workflow/actions/rebase.mdx

@@ -4,7 +4,6 @@ description: Rebase the pull request on top of its base branch.
 ---
 
 import ActionOptionsTable from '../../../../components/Tables/ActionOptionsTable'
-import Button from '../../../../components/Button.astro';
 
 The `rebase` action makes Mergify rebase the pull request on top of its base
 branch. This is useful when you want to ensure that your pull request is always
@@ -27,9 +26,3 @@ up-to-date with the latest changes from the base branch.
 ## Parameters
 
 <ActionOptionsTable def='RebaseActionModel'/>
-
-## Examples
-
-<Button colorScheme='teal' href="/workflow/rebase#automatically-rebasing-prs">
-  Read Rebase Use Cases
-</Button>

src/content/docs/workflow/actions/request_reviews.mdx

@@ -4,7 +4,6 @@ description: Request reviews from specific users or teams.
 ---
 
 import ActionOptionsTable from '../../../../components/Tables/ActionOptionsTable'
-import Button from '../../../../components/Button.astro';
 
 The `request_reviews` action lets Mergify request reviews from specified users
 or teams. This is useful when you want to ensure specific team members review
@@ -17,12 +16,3 @@ certain pull requests.
 ## Parameters
 
 <ActionOptionsTable def="RequestReviewsActionModel" />
-
-## Use Cases
-
-There are plenty of possibilities for the request reviews action. Read below to
-discover them.
-
-<Button href="/workflow/request-reviews" colorScheme='blue'>
-  See Request Reviews Use Cases
-</Button>