docs(stacks): rewrite stacks section as full product documentation#10970
Merged
mergify[bot] merged 1 commit intomainfrom Apr 10, 2026
Merged
Conversation
Member
Author
|
This pull request is part of a stack:
|
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.
|
jd
force-pushed
the
devs/jd/worktree-stacks/I82cec436ccacfeccbf29498db92057983dc337ea
branch
from
83a663a to
c0e3f4a
Compare
There was a problem hiding this comment.
Pull request overview
This PR rewrites the existing single-page Stacks documentation into a full multi-page product section and updates navigation/UI components to support the new docs structure.
Changes:
- Adds a full “Stacks” documentation section (overview + 6 subpages) with diagrams and screenshots.
- Updates site navigation to include a dedicated “Stacks” sidebar group with child pages.
- Introduces a new
StackMappingdiagram component and tweaksGitGraphlinear rendering sizing/padding for better layout.
Reviewed changes
Copilot reviewed 10 out of 14 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| src/content/navItems.tsx | Adds a “Stacks” nav group with subpages; removes the old single-link entry. |
| src/content/images/stack-comment.png | Adds screenshot used in Stacks reviewer/overview docs. |
| src/content/images/github-delete-head-branches.png | Adds screenshot used in Stacks setup prerequisites. |
| src/content/docs/stacks.mdx | Replaces the old Stacks page with a landing page + docset grid + diagrams. |
| src/content/docs/stacks/concepts.mdx | Adds “Concepts” page covering Change-Id, branch mapping, PR chaining, and smart updates. |
| src/content/docs/stacks/setup.mdx | Adds “Setup” page with prerequisites, setup steps, verification, and config options. |
| src/content/docs/stacks/creating.mdx | Adds “Creating Stacks” tutorial including screenshots and CLI workflow. |
| src/content/docs/stacks/updating.mdx | Adds “Updating Stacks” guide for amend/edit/reorder/add/drop/squash and post-merge behavior. |
| src/content/docs/stacks/reviewing.mdx | Adds reviewer guide explaining stacked PR navigation and workflow. |
| src/content/docs/stacks/team.mdx | Adds team adoption/rollout guidance and comparison table. |
| src/components/StackMapping.astro | New SVG diagram component for explaining commit→branch→PR mapping. |
| src/components/GitGraph.astro | Adjusts linear layout padding and adds dynamic max-width sizing for rendered SVGs. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
mergify
bot
added
review threads unresolved
and removed
review threads unresolved
labels
jd
force-pushed
the
devs/jd/worktree-stacks/I720770b645e7a50ee7fcb8288fa1651675fda44a
branch
from
97a81ca to
6af92de
Compare
jd
force-pushed
the
devs/jd/worktree-stacks/I82cec436ccacfeccbf29498db92057983dc337ea
branch
from
c0e3f4a to
b62096a
Compare
sileht
previously approved these changes
Apr 10, 2026
Base automatically changed from
devs/jd/worktree-stacks/I720770b645e7a50ee7fcb8288fa1651675fda44a
to
main
April 10, 2026 07:04
Contributor
|
@jd this pull request is now in conflict 😩 |
Replace the single /stacks page with a 7-page product section: - Landing page with product pitch and DocsetGrid - Concepts (Change-Id, branch mapping, PR chaining) - Setup (CLI install, hook verification, config) - Creating Stacks (end-to-end tutorial) - Updating Stacks (amend, reorder, squash, add, remove) - Reviewing Stacks (reviewer's guide) - Team Adoption (rollout guide, comparison with alternatives) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Change-Id: I82cec436ccacfeccbf29498db92057983dc337ea Claude-Session-Id: a911b6ad-5466-48a4-b4d3-85198ebc7c28
jd
force-pushed
the
devs/jd/worktree-stacks/I82cec436ccacfeccbf29498db92057983dc337ea
branch
from
b62096a to
f9fcb6d
Compare
JulianMaurin
approved these changes
Apr 10, 2026
sileht
approved these changes
Apr 10, 2026
Contributor
Merge Queue Status
This pull request spent 2 minutes 56 seconds in the queue, including 2 minutes 33 seconds running CI. Required conditions to merge
|
49 tasks
mergify
bot
deleted the
devs/jd/worktree-stacks/I82cec436ccacfeccbf29498db92057983dc337ea
branch
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 single /stacks page with a 7-page product section:
Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com