Skip to content

docs(integrations): rename Monorepo CI to Job Selection - #12860

Open
jd wants to merge 1 commit into
mainfrom
devs/jd/jd/mrgfy-9345-rename-monorepo-ci-to-job-selection-in-the-github-actions/rename-monorepo-ci-job-selection--699fe803
Open

jd wants to merge 1 commit into
mainfrom
devs/jd/jd/mrgfy-9345-rename-monorepo-ci-to-job-selection-in-the-github-actions/rename-monorepo-ci-job-selection--699fe803

Conversation

@jd

@jd jd commented Sep 16, 2026

Copy link
Copy Markdown
Member

"Monorepo CI" named the topic rather than the feature: it is scopes deciding
which CI jobs or Buildkite steps a pull request needs. "Job Selection" says
what it does and sits next to Test Selection as its job-level sibling.

  • Rename the section, intro, feature bullet and frontmatter description on
    the GitHub Actions and Buildkite integration pages, and the two cards on
    the integrations index.
  • Move the anchor to #job-selection on every page that links to it
    (merge queue monorepo guide, scopes, file-pattern scopes, partitions
    migration) and in the /monorepo-ci* redirects.
  • Keep a hidden monorepo-ci anchor above each renamed heading, so links to
    the old anchor still land on the section instead of the top of the page.
    A fragment never reaches the server, so a redirect cannot do this.
  • Rename the example workflow from Monorepo CI to CI, and the job
    summary screenshot file to match the new name.

Fixes MRGFY-9345

Co-Authored-By: Claude Opus 5 (1M context) noreply@anthropic.com

Copilot AI lite review requested due to automatic review settings September 16, 2026 12:35
@mergify
mergify Bot had a problem deploying to Mergify Merge Protections September 16, 2026 12:35 Failure
@mergify

mergify Bot commented Sep 16, 2026

Copy link
Copy Markdown
Contributor

Merge Protections

🔴 1 of 5 protections blocking · waiting on 👀 reviews

Protection Waiting on
🔴 👀 Review Requirements 👀 reviews
🟢 Enforce conventional commit
🟢 🔎 Reviews
🟢 📕 PR description
🟢 🚦 Auto-queue

🔴 👀 Review Requirements

Waiting for

  • #approved-reviews-by >= 1
This rule is failing.
  • any of:
    • #approved-reviews-by >= 1
    • author = dependabot[bot]
    • author = renovate[bot]
    • all of:
      • author = mergify-ci-bot
      • -head ~= ^docs-agent/

Show 4 satisfied protections

🟢 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.

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.

🔵 Needs a closer look

Add #job-selection to the remaining .md legacy redirects.

Pull request overview

Renames the “Monorepo CI” integration feature to “Job Selection” while updating related links, anchors, redirects, and assets.

Changes:

  • Updates integration documentation, cards, and descriptions.
  • Migrates internal links to #job-selection while preserving legacy anchors.
  • Renames the workflow example and screenshot asset.
File summaries
File Summary
src/content/docs/merge-queue/scopes/file-patterns.mdx Updates Job Selection references.
src/content/docs/merge-queue/scopes.mdx Updates integration links.
src/content/docs/merge-queue/monorepo.mdx Updates Job Selection links.
src/content/docs/merge-queue/migrate-partitions-to-scopes.mdx Updates the integration link.
src/content/docs/integrations/gha.mdx Renames GitHub Actions feature content and screenshot reference.
src/content/docs/integrations/buildkite.mdx Renames Buildkite feature content.
src/content/docs/integrations.mdx Updates integration cards.
public/_redirects Updates legacy redirects; some .md routes still lack the new fragment.
Review details

Suppressed comments (1)

public/_redirects:96

  • The .md legacy routes immediately below these entries (/monorepo-ci.md, /monorepo-ci/github-actions.md, and /monorepo-ci/buildkite.md) still redirect without a fragment, so those /monorepo-ci* URLs land at the top of the integration page while the other variants land at Job Selection. Add #job-selection to these destinations as well so every legacy route preserves the section target described by this change.
/monorepo-ci /integrations/gha#job-selection 301
/monorepo-ci/ /integrations/gha#job-selection 301
  • Files reviewed: 8/9 changed files
  • Comments generated: 0
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@jd
jd marked this pull request as ready for review September 16, 2026 12:44
"Monorepo CI" named the topic rather than the feature: it is scopes deciding
which CI jobs or Buildkite steps a pull request needs. "Job Selection" says
what it does and sits next to Test Selection as its job-level sibling.

- Rename the section, intro, feature bullet and frontmatter description on
  the GitHub Actions and Buildkite integration pages, and the two cards on
  the integrations index.
- Move the anchor to `#job-selection` on every page that links to it
  (merge queue monorepo guide, scopes, file-pattern scopes, partitions
  migration) and in the `/monorepo-ci*` redirects.
- Keep a hidden `monorepo-ci` anchor above each renamed heading, so links to
  the old anchor still land on the section instead of the top of the page.
  A fragment never reaches the server, so a redirect cannot do this.
- Rename the example workflow from `Monorepo CI` to `CI`, and the job
  summary screenshot file to match the new name.

Fixes MRGFY-9345

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Change-Id: I699fe8039b79e1d7370f8f9439a6cc20c536b420
@jd
jd force-pushed the devs/jd/jd/mrgfy-9345-rename-monorepo-ci-to-job-selection-in-the-github-actions/rename-monorepo-ci-job-selection--699fe803 branch from 304623c to 8805e54 Compare September 16, 2026 13:48
@jd

jd commented Sep 16, 2026

Copy link
Copy Markdown
Member Author

Revision history

# Type Changes Reason Date
1 initial 304623c 2026-09-16 13:48 UTC
2 rebase 304623c → 8805e54 (rebase only) rebase onto main to pick up the build fix from #12859 (main was failing build/lint) 2026-09-16 13:48 UTC

@jd

jd commented Sep 16, 2026

Copy link
Copy Markdown
Member Author

Rebased onto main to pick up the build fix from #12859. Main was failing build/lint, and the diff here is unchanged: https://github.com/Mergifyio/docs/compare/304623c5fdb2d1f70bc19da593060ff276140aad..8805e54898e7

I left Copilot's suggestion about the .md redirects alone. /monorepo-ci.md and its siblings point at the raw Markdown export (/integrations/gha.md), where a fragment means nothing, and none of the .md rules in _redirects use one.

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.

2 participants