Skip to content

docs(mq): add scopes #9467

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 3 commits into from
Nov 24, 2025
Merged

docs(mq): add scopes #9467

merged 3 commits into from
Nov 24, 2025
+173 −6

Conversation

@jd
Copy link
Member

@jd jd commented Nov 21, 2025

This adds a general documentation page on the scope features for itself.

@jd
docs(mq): add scopes
2c9bd55 
This adds a general documentation page on the scope features for itself.

Change-Id: I87095c316b9a9995f59cf54ea29d5d7955dd477e
Copilot AI review requested due to automatic review settings November 21, 2025 15:17
@mergify mergify bot had a problem deploying to Mergify Merge Protections November 21, 2025 15:17 Failure
@mergify
Copy link
Contributor

mergify bot commented Nov 21, 2025 •
edited
Loading

Merge Protections

Your pull request matches the following merge protections and will not be merged until they are valid.

🟢 🤖 Continuous Integration

Wonderful, this rule succeeded.
  • all of:
    • check-success = build
    • check-success = lint
    • check-success = test
    • any of:
      • check-success = test-broken-links
      • label = ignore-broken-links
    • any of:
      • check-success=Cloudflare Pages
      • -head-repo-full-name~=^Mergifyio/

🟢 👀 Review Requirements

Wonderful, this rule succeeded.
  • any of:
    • #approved-reviews-by >= 2
    • author = dependabot[bot]
    • author = mergify-ci-bot

🟢 Enforce conventional commit

Wonderful, this rule succeeded.

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

  • title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert)(?:\(.+\))?:

🟢 🔎 Reviews

Wonderful, this rule succeeded.
  • #changes-requested-reviews-by = 0
  • #review-requested = 0
  • #review-threads-unresolved = 0

🟢 📕 PR description

Wonderful, this rule succeeded.
  • body ~= (?ms:.{48,})

@mergify mergify bot requested a review from a team November 21, 2025 15:18
Copilot finished reviewing on behalf of jd November 21, 2025 15:19
Copilot AI reviewed Nov 21, 2025
View reviewed changes
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds comprehensive documentation for Mergify's scopes feature, which enables intelligent batching of pull requests based on the areas of code they modify. The documentation explains how scope-aware batching optimizes CI resource usage by grouping related changes together, particularly beneficial for monorepo environments.

Key changes:

  • New dedicated documentation page explaining scopes, their lifecycle, configuration, and best practices
  • Navigation menu updated to include the new Scopes page
  • Cross-references added from existing merge queue and monorepo documentation

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
src/content/navItems.tsx Adds "Scopes" navigation item with FaLayerGroup icon between Batches and Two-Step CI
src/content/docs/merge-queue/scopes.mdx New comprehensive documentation page covering scope-aware batching, configuration, and usage
src/content/docs/merge-queue/monorepo.mdx Adds cross-reference link to the new scopes documentation
src/content/docs/merge-queue.mdx Adds scope-aware batching as a cost optimization strategy with proper formatting

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

sileht
sileht previously approved these changes Nov 21, 2025
View reviewed changes
jd and others added 2 commits November 21, 2025 16:58
@jd
Update src/content/docs/merge-queue/scopes.mdx
0fcb02f 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@jd
Update src/content/docs/merge-queue/scopes.mdx
e415706 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@mergify mergify bot dismissed sileht’s stale review November 21, 2025 15:59

Pull request has been modified.

@mergify mergify bot deployed to Mergify Merge Protections November 21, 2025 15:59 Active
@mergify
Copy link
Contributor

mergify bot commented Nov 21, 2025 •
edited
Loading

Merge Queue Status Beta

🚫 The pull request has left the queue (rule: default)

This pull request spent 11 seconds in the queue, with no time waiting for CI.

Reason

The draft pull request cannot be created

Hint

If you want to requeue this pull request, you can post a @mergifyio requeue comment.

mergify bot added a commit that referenced this pull request Nov 21, 2025
@mergify
Merge of #9467
05174f3
@mergify mergify bot added the queued label Nov 21, 2025
mergify bot added a commit that referenced this pull request Nov 21, 2025
@mergify
Merge of #9467
c2defbf
@mergify mergify bot mentioned this pull request Nov 21, 2025
Closed
59 tasks
@mergify
Copy link
Contributor

mergify bot commented Nov 21, 2025 •
edited
Loading

Merge Queue Status Beta

🚫 The pull request has left the queue (rule: default)

This pull request spent 28 seconds in the queue, including 14 seconds waiting for CI.
The checks were run on draft #9469.

Required conditions to merge

Reason

The merge conditions cannot be satisfied due to failing checks

Failing checks:

Hint

You may have to fix your CI before adding the pull request to the queue again.
If you update this pull request, to fix the CI, it will automatically be requeued once the queue conditions match again.
If you think this was a flaky issue instead, you can requeue the pull request, without updating it, by posting a @mergifyio requeue comment.

@mergify mergify bot mentioned this pull request Nov 21, 2025
Closed
59 tasks
@mergify mergify bot added the queued label Nov 21, 2025
@mergify
Copy link
Contributor

mergify bot commented Nov 21, 2025

Merge Queue Status Beta

🚫 The pull request has left the queue (rule: default)

This pull request spent 28 seconds in the queue, with no time waiting for CI.

Required conditions to merge

Reason

The merge conditions cannot be satisfied due to failing checks

Failing checks:

Hint

You may have to fix your CI before adding the pull request to the queue again.
If you update this pull request, to fix the CI, it will automatically be requeued once the queue conditions match again.
If you think this was a flaky issue instead, you can requeue the pull request, without updating it, by posting a @mergifyio requeue comment.

@mergify mergify bot removed the queued label Nov 21, 2025
@mergify mergify bot added the dequeued label Nov 21, 2025
@jd
Copy link
Member Author

jd commented Nov 24, 2025

@Mergifyio requeue

@mergify
Copy link
Contributor

mergify bot commented Nov 24, 2025

requeue

✅ This pull request will be re-embarked automatically

The followup queue command will be automatically executed to re-embark the pull request.

@mergify
Copy link
Contributor

mergify bot commented Nov 24, 2025 •
edited
Loading

queue

✅ The pull request has been merged automatically

The pull request has been merged automatically at 214706c

@mergify
Copy link
Contributor

mergify bot commented Nov 24, 2025 •
edited
Loading

Merge Queue Status Beta

✅ The pull request has been merged

This pull request spent 2 minutes 26 seconds in the queue, including 1 minute 48 seconds waiting for CI.
The checks were run on draft #9478.

Required conditions to merge

@mergify mergify bot added queued and removed dequeued labels Nov 24, 2025
mergify bot added a commit that referenced this pull request Nov 24, 2025
@mergify
Merge of #9467
edfbece
mergify bot added a commit that referenced this pull request Nov 24, 2025
@mergify
Merge of #9467
02f6453
@mergify mergify bot mentioned this pull request Nov 24, 2025
Closed
59 tasks
@mergify mergify bot merged commit 214706c into main Nov 24, 2025
8 checks passed
@mergify mergify bot deleted the devs/jd/monorepo/I87095c316b9a9995f59cf54ea29d5d7955dd477e branch November 24, 2025 09:46
@mergify mergify bot removed the queued label Nov 24, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

@sileht sileht sileht approved these changes

@JulianMaurin JulianMaurin JulianMaurin approved these changes

Assignees

No one assigned

Labels

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@jd @sileht @JulianMaurin