Skip to content

docs: fold Monorepo CI into the GitHub Actions and Buildkite integrations - #12268

Merged
mergify[bot] merged 1 commit into
mainfrom
devs/sileht/docs-monorepo-ci-into-integrations/fold-monorepo-ci-github-actions-buildkite--2f4584a8
Jul 30, 2026
Merged

docs: fold Monorepo CI into the GitHub Actions and Buildkite integrations#12268
mergify[bot] merged 1 commit into
mainfrom
devs/sileht/docs-monorepo-ci-into-integrations/fold-monorepo-ci-github-actions-buildkite--2f4584a8

Conversation

@sileht

@sileht sileht commented Jul 30, 2026

Copy link
Copy Markdown
Member

Monorepo CI is not a product, it is an advanced way to consume scopes on a
specific CI. Sitting at the top level next to Merge Queue and CI Insights, it
read as a third product: customers who wanted scope-aware batching or parallel
mode clicked "Monorepo CI" and landed on a GitHub Actions job-skipping guide
instead of /merge-queue/scopes.

Delete the overview and the two per-CI setup guides, inlining their setup
content as a "Monorepo CI" section on /integrations/gha and
/integrations/buildkite. /merge-queue/scopes stays the single canonical
explanation of what scopes are; each new section opens by saying plainly that
it covers CI job skipping and points at scopes for batching and parallel mode.

The old URLs 301 to the integration pages.

…ions

Monorepo CI is not a product, it is an advanced way to consume scopes on a
specific CI. Sitting at the top level next to Merge Queue and CI Insights, it
read as a third product: customers who wanted scope-aware batching or parallel
mode clicked "Monorepo CI" and landed on a GitHub Actions job-skipping guide
instead of /merge-queue/scopes.

Delete the overview and the two per-CI setup guides, inlining their setup
content as a "Monorepo CI" section on /integrations/gha and
/integrations/buildkite. /merge-queue/scopes stays the single canonical
explanation of what scopes are; each new section opens by saying plainly that
it covers CI job skipping and points at scopes for batching and parallel mode.

The old URLs 301 to the integration pages.

Change-Id: I2f4584a8da4c7733a1ab05930a339745c926125a
Copilot AI review requested due to automatic review settings July 30, 2026 11:09
@mergify
mergify Bot deployed to Mergify Merge Protections July 30, 2026 11:09 Active
@mergify

mergify Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Merge Protections

🟢 All 6 merge protections satisfied — ready to merge.

Show 6 satisfied protections

🟢 🤖 Continuous Integration

  • 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

  • any of:
    • #approved-reviews-by >= 2
    • author = dependabot[bot]
    • author = mergify-ci-bot

🟢 Enforce conventional commit

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

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

🟢 🔎 Reviews

  • #changes-requested-reviews-by = 0
  • #review-requested = 0
  • #review-threads-unresolved = 0

🟢 📕 PR description

  • body ~= (?ms:.{48,})

🟢 🚦 Auto-queue

When all merge protections are satisfied, this pull request will be queued automatically.

@mergify
mergify Bot requested a review from a team July 30, 2026 11:11

Copilot AI left a comment

Copy link
Copy Markdown

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 restructures the documentation so “Monorepo CI” is no longer presented as a top-level product area, and instead becomes provider-specific guidance embedded within the GitHub Actions and Buildkite integration pages, with old Monorepo CI URLs redirected accordingly.

Changes:

  • Removed the Monorepo CI top-level nav section and deleted the standalone Monorepo CI overview + per-CI setup guides.
  • Inlined Monorepo CI setup content into /integrations/gha and /integrations/buildkite, and updated existing scope docs to point to these new sections.
  • Added redirects from the old /monorepo-ci/* routes to the new integration sections.

Reviewed changes

Copilot reviewed 12 out of 13 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
src/content/navItems.tsx Removes “Monorepo CI” from the top-level navigation.
src/content/docs/monorepo-ci.mdx Deletes the former Monorepo CI overview page.
src/content/docs/monorepo-ci/github-actions.mdx Deletes the former GitHub Actions Monorepo CI guide (content moved to integrations).
src/content/docs/monorepo-ci/buildkite.mdx Deletes the former Buildkite Monorepo CI guide (content moved to integrations).
src/content/docs/integrations/gha.mdx Adds an in-page “Monorepo CI” section with GHA job-skipping guidance and examples.
src/content/docs/integrations/buildkite.mdx Adds an in-page “Monorepo CI” section with Buildkite step-skipping guidance and examples.
src/content/docs/merge-queue/scopes/file-patterns.mdx Updates references to point to the new Monorepo CI integration sections.
src/content/docs/merge-queue/scopes.mdx Updates the “scopes outside merge queue” callout to link to integration sections.
src/content/docs/merge-queue/monorepo.mdx Replaces Monorepo CI links with integration section links.
src/content/docs/merge-queue/migrate-partitions-to-scopes.mdx Updates the tip link to the GitHub Actions integration Monorepo CI section.
public/_redirects Adds redirects for old Monorepo CI URLs to the new integration sections.
.claude/skills/document-a-feature/references/placement-guide.md Updates internal placement guidance to remove the monorepo-ci/ docs section.
Comments suppressed due to low confidence (2)

public/_redirects:92

  • Redirect targets ending in .md likely don't exist as routes in the built Astro site (the pages are /integrations/gha and /integrations/buildkite). This redirect will probably send users to a 404. Point it to the integration page (and keep the #monorepo-ci anchor for the in-page section).
/monorepo-ci/github-actions.md /integrations/gha.md 301

public/_redirects:95

  • Redirect target ends with .md, which likely isn't a valid route in the built site. Redirect to the integration page URL (and include the #monorepo-ci anchor so users land on the right section).
/monorepo-ci/buildkite.md /integrations/buildkite.md 301

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

Comment thread public/_redirects
@sileht
sileht marked this pull request as ready for review July 30, 2026 13:06
@mergify
mergify Bot requested a review from a team July 30, 2026 13:17
@mergify

mergify Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Merge Queue Status

This pull request spent 2 minutes 34 seconds in the queue, including 2 minutes 14 seconds running CI.

Required conditions to merge

@mergify mergify Bot added the queued label Jul 30, 2026
@mergify
mergify Bot merged commit 3ff3775 into main Jul 30, 2026
11 checks passed
@mergify
mergify Bot deleted the devs/sileht/docs-monorepo-ci-into-integrations/fold-monorepo-ci-github-actions-buildkite--2f4584a8 branch July 30, 2026 13:24
@mergify mergify Bot removed the queued label Jul 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

4 participants