docs: fold Monorepo CI into the GitHub Actions and Buildkite integrations - #12268
Conversation
…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
Merge Protections🟢 All 6 merge protections satisfied — ready to merge. Show 6 satisfied protections🟢 🤖 Continuous Integration
🟢 👀 Review Requirements
🟢 Enforce conventional commitMake sure that we follow https://www.conventionalcommits.org/en/v1.0.0/
🟢 🔎 Reviews
🟢 📕 PR description
🟢 🚦 Auto-queueWhen all merge protections are satisfied, this pull request will be queued automatically. |
There was a problem hiding this comment.
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/ghaand/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
.mdlikely don't exist as routes in the built Astro site (the pages are/integrations/ghaand/integrations/buildkite). This redirect will probably send users to a 404. Point it to the integration page (and keep the#monorepo-cianchor 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-cianchor 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.
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
|
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.