docs(stacks): sync stacks docs with current CLI#11820
Merged
mergify[bot] merged 1 commit intoJun 16, 2026
Merged
Conversation
Contributor
Merge ProtectionsYour pull request matches the following merge protections and will not be merged until they are valid. 🟢 🤖 Continuous IntegrationWonderful, this rule succeeded.
🟢 👀 Review RequirementsWonderful, this rule succeeded.
🟢 Enforce conventional commitWonderful, this rule succeeded.Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/
🟢 🔎 ReviewsWonderful, this rule succeeded.
🟢 📕 PR descriptionWonderful, this rule succeeded.
|
There was a problem hiding this comment.
Pull request overview
Updates the Mergify Stacks documentation to match the current CLI workflow, replacing interactive rebase-driven instructions with dedicated mergify stack subcommands and adding reviewer-facing guidance for revision history.
Changes:
- Reworked Updating Stacks to document non-interactive history rewrite commands (
edit,reword,reorder,move,drop,fixup,squash), plus--dry-run,stack note, andstack sync. - Documented the new
mergify-cli.stack-revision-historysetting and added a Revision History section (with screenshot) to the reviewer guide. - Refreshed comparison tables (Graphite, gh-stack) and adjusted positioning on the Stacks landing page.
Reviewed changes
Copilot reviewed 6 out of 8 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| src/content/docs/stacks/updating.mdx | Replaces interactive rebase walkthroughs with dedicated mergify stack rewrite/sync/note commands and revision-history behavior. |
| src/content/docs/stacks/setup.mdx | Adds mergify-cli.stack-revision-history to the configuration table. |
| src/content/docs/stacks/reviewing.mdx | Adds a Revision History section and screenshot, plus a browser-extension cross-reference. |
| src/content/docs/stacks/compare/graphite.mdx | Updates comparison rows for edit/reorder/squash flows to match new CLI subcommands. |
| src/content/docs/stacks/compare/gh-stack.mdx | Updates comparison rows for edit/squash and clarifies stack visualization via extension panel. |
| src/content/docs/stacks.mdx | Softens the “no new commands” positioning on the Stacks landing page. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
jd
force-pushed
the
devs/jd/worktree-update-stacks/sync-stacks-docs-current-cli--084ff85f
branch
from
4655a2b to
95102a3
Compare
Member
Author
|
This pull request is part of a Mergify stack:
|
Member
Author
Revision history
|
jd
force-pushed
the
devs/jd/worktree-update-stacks/sync-stacks-docs-current-cli--084ff85f
branch
from
95102a3 to
4a7c17e
Compare
Replace the git rebase -i flows in the Updating Stacks guide with the dedicated non-interactive subcommands the CLI now ships: edit/reword/reorder/move/drop/fixup/squash, each with --dry-run. Document the revision-history comment and `mergify stack note`, add a revision-history section (and browser-extension screenshot) to the reviewing guide, add the stack-revision-history git config option, and use `mergify stack sync` after a merge instead of a bare re-push. Refresh the stack-comment screenshot to the current table layout, fix stale "interactive rebase" rows in the gh-stack and Graphite comparison tables, and soften the landing-page claim that there are no new commands to learn. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Change-Id: I084ff85fe6c9214271eaa9d4bd0d9620777d540a
jd
force-pushed
the
devs/jd/worktree-update-stacks/sync-stacks-docs-current-cli--084ff85f
branch
from
4a7c17e to
671150e
Compare
kozlek
approved these changes
Jun 15, 2026
remyduthu
approved these changes
Jun 15, 2026
Contributor
|
Queued — the merge queue status continues in this comment ↓. |
Contributor
Merge Queue Status
This pull request spent 14 hours 15 minutes 24 seconds in the queue, including 2 minutes 5 seconds running CI. Required conditions to merge
|
51 tasks
mergify
Bot
deleted the
devs/jd/worktree-update-stacks/sync-stacks-docs-current-cli--084ff85f
branch
53 tasks
mergify Bot
pushed a commit
that referenced
this pull request
Jun 16, 2026
Add an honest comparison between Mergify Stacks and stacking by hand with `git rebase` + `gh pr create`, the baseline every other stacking tool is measured against. Covers the manual recipe and its upkeep cost, a feature-by-feature table, a candid "when plain Git is enough" section, where Stacks pulls ahead (self-maintaining chain, Change-Id identity across rewrites, reviewer context, Merge Queue integration), an incremental "coming from a custom script" path, and an explicit off-ramp note. Wire it into the compare index grid. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Depends-On: #11820
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Replace the git rebase -i flows in the Updating Stacks guide with the
dedicated non-interactive subcommands the CLI now ships:
edit/reword/reorder/move/drop/fixup/squash, each with --dry-run.
Document the revision-history comment and
mergify stack note, add arevision-history section (and browser-extension screenshot) to the
reviewing guide, add the stack-revision-history git config option, and
use
mergify stack syncafter a merge instead of a bare re-push.Refresh the stack-comment screenshot to the current table layout, fix
stale "interactive rebase" rows in the gh-stack and Graphite comparison
tables, and soften the landing-page claim that there are no new commands
to learn.
Co-Authored-By: Claude Opus 4.8 (1M context) noreply@anthropic.com