docs site content updates#28
Merged
Conversation
skarim
commented
Apr 14, 2026
Collaborator
- Added private preview callout banners
- Expanded squash merge FAQ with examples
- Clarified bottom-up merge process
- Clarified CLI as optional with guidance on how to use with other tools
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the Stacked PRs docs site to better set expectations for private preview availability, clarify merge behavior for stacks, and expand documentation around squash-merge rebasing and CLI-optional workflows.
Changes:
- Added “Private Preview” callouts (home + Quick Start) to prevent confusion when the feature isn’t enabled.
- Clarified bottom-up / contiguous-group merge behavior and expanded guidance that the
gh stackCLI is optional (including “bring your own tools”). - Expanded the squash-merge FAQ with a concrete
git rebase --ontoexplanation and example.
Show a summary per file
| File | Description |
|---|---|
| docs/src/styles/custom.css | Styles inline code in the hero tagline and improves copy-button visibility for light-themed code blocks. |
| docs/src/content/docs/introduction/overview.md | Adds a squash-merge handling callout and expands CLI-optional + BYO tools guidance with FAQ links. |
| docs/src/content/docs/index.mdx | Updates homepage messaging to emphasize CLI optionality and adds a Private Preview caution aside. |
| docs/src/content/docs/guides/stacked-prs.md | Clarifies bottom-up merging to explicitly allow contiguous-group merges from the lowest unmerged PR. |
| docs/src/content/docs/getting-started/quick-start.md | Adds a Private Preview caution banner near prerequisites. |
| docs/src/content/docs/faq.md | Significantly expands the squash-merge explanation with rebase --onto and an illustrative example. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 6/6 changed files
- Comments generated: 0
AdamShwert
approved these changes
Apr 14, 2026
AdamShwert
left a comment
There was a problem hiding this comment.
Didn't see any typos, content seems good!
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.