Skip to content

refactor(stacks): extract shared install snippets into partials#11826

Open
jd wants to merge 1 commit into
mainfrom
devs/jd/worktree-update-stacks/extract-shared-install-snippets-partials--54a063e7
Open

refactor(stacks): extract shared install snippets into partials#11826
jd wants to merge 1 commit into
mainfrom
devs/jd/worktree-update-stacks/extract-shared-install-snippets-partials--54a063e7

Conversation

@jd

@jd jd commented Jun 13, 2026

Copy link
Copy Markdown
Member

The install/quickstart command blocks were copy-pasted across the stacks
docs, so a command change meant editing every page. Extract three MDX
partials (_install, _install-setup, _quickstart) and use them on the
landing, setup, agents, plain-git, gh-stack, and graphite pages so the
commands live in one place.

Addresses review feedback on the "vs Plain Git" page where the install
block was duplicated.

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

@mergify mergify Bot had a problem deploying to Mergify Merge Protections June 13, 2026 19:26 Failure
@jd

jd commented Jun 13, 2026

Copy link
Copy Markdown
Member Author

This pull request is part of a Mergify stack:

# Pull Request Link
1 docs(stacks): sync stacks docs with current CLI #11820
2 docs(stacks): add "vs Plain Git" comparison page #11822
3 docs: move Browser Extensions out of the Merge Queue section #11825
4 refactor(stacks): extract shared install snippets into partials #11826 👈
5 docs: install the CLI via the install script #11839

@mergify

mergify Bot commented Jun 13, 2026

Copy link
Copy Markdown
Contributor

Merge Protections

🔴 2 of 5 protections blocking · waiting on 👀 reviews

Protection Waiting on
🔴 👀 Review Requirements 👀 reviews
🔴 🔎 Reviews 👀 reviews
🟢 🤖 Continuous Integration
🟢 Enforce conventional commit
🟢 📕 PR description

🔴 👀 Review Requirements

Waiting for

  • #approved-reviews-by >= 2
This rule is failing.
  • any of:
    • #approved-reviews-by >= 2
    • author = dependabot[bot]
    • author = mergify-ci-bot

🔴 🔎 Reviews

Waiting for

  • #review-requested = 0
  • #review-threads-unresolved = 0
This rule is failing.
  • #review-requested = 0
  • #review-threads-unresolved = 0
  • #changes-requested-reviews-by = 0

@mergify mergify Bot requested a review from a team June 13, 2026 19:29
@jd jd marked this pull request as ready for review June 15, 2026 08:10
@mergify mergify Bot force-pushed the devs/jd/worktree-update-stacks/move-browser-extensions-merge-queue-section--2e6ed322 branch from c042289 to 3636e4d Compare June 16, 2026 07:51
@mergify

mergify Bot commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

A predecessor in this stack was just merged, but I couldn't auto-rebase this PR: there's a conflict that needs human resolution.

Conflict in: src/content/docs/stacks/compare/gh-stack.mdx, src/content/docs/stacks/reviewing.mdx (replayed onto 0900ecdd).

Resolve by rebasing this branch onto the latest base and pushing.

@mergify

mergify Bot commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

@jd this pull request is now in conflict 😩

@mergify mergify Bot added the conflict label Jun 16, 2026
Base automatically changed from devs/jd/worktree-update-stacks/move-browser-extensions-merge-queue-section--2e6ed322 to main June 16, 2026 08:22
sileht
sileht previously approved these changes Jun 16, 2026
@mergify mergify Bot requested a review from a team June 16, 2026 13:24
The install/quickstart command blocks were copy-pasted across the stacks
docs, so a command change meant editing every page. Extract three MDX
partials (_install, _install-setup, _quickstart) and use them on the
landing, setup, agents, plain-git, gh-stack, and graphite pages so the
commands live in one place.

Addresses review feedback on the "vs Plain Git" page where the install
block was duplicated.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Change-Id: I54a063e7c281920699defa903bdf82cbafe984f7
Copilot AI review requested due to automatic review settings June 16, 2026 14:45
@jd jd force-pushed the devs/jd/worktree-update-stacks/extract-shared-install-snippets-partials--54a063e7 branch from 32eea54 to 46a4950 Compare June 16, 2026 14:45
@jd

jd commented Jun 16, 2026

Copy link
Copy Markdown
Member Author

Revision history

# Type Changes Reason Date
1 initial 32eea54 2026-06-16 14:45 UTC
2 rebase 32eea54 → 46a4950 (rebase only) 2026-06-16 14:45 UTC

@mergify mergify Bot dismissed sileht’s stale review June 16, 2026 14:46

Pull request has been modified.

@mergify mergify Bot had a problem deploying to Mergify Merge Protections June 16, 2026 14:46 Failure
@mergify mergify Bot removed the conflict label Jun 16, 2026

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 refactors the Stacks documentation to remove duplicated CLI install/setup/quickstart command blocks by extracting them into reusable MDX partials and embedding those partials across the Stacks landing, setup, agents, and comparison pages.

Changes:

  • Added three MDX partials for shared command blocks: install, install+setup, and quickstart.
  • Replaced inline fenced command blocks with <Install />, <InstallSetup />, and <Quickstart /> components across affected pages.
  • Updated relevant pages to import and render the new partial components.

Reviewed changes

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

Show a summary per file
File Description
src/content/docs/stacks/setup.mdx Imports and uses the shared install snippet instead of an inline code block.
src/content/docs/stacks/compare/plain-git.mdx Replaces duplicated install/setup and quickstart blocks with shared partial components.
src/content/docs/stacks/compare/graphite.mdx Uses the shared install+setup snippet in the migration section.
src/content/docs/stacks/compare/gh-stack.mdx Uses the shared install+setup snippet in the migration section.
src/content/docs/stacks/agents.mdx Replaces the uv install block with the shared install partial (but needs import placement fix).
src/content/docs/stacks/_quickstart.mdx New partial containing the quickstart command block.
src/content/docs/stacks/_install.mdx New partial containing the install command block.
src/content/docs/stacks/_install-setup.mdx New partial containing the install + setup command block.
src/content/docs/stacks.mdx Imports and uses the shared quickstart snippet on the Stacks landing page.

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

Comment on lines 6 to 12
You are an AI coding agent. Follow these three steps to enable stacked pull
request support. After step 2, your skill system will contain the full Stacks
workflow. Consult it for any stack-related task.

import Install from './_install.mdx';

## 1. Install the Mergify CLI
@mergify mergify Bot requested a review from a team June 16, 2026 14:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Development

Successfully merging this pull request may close these issues.

4 participants