Skip to content

docs: document stacked pull requests in development setup - #1617

Merged
ananthsub merged 2 commits into
mainfrom
ananthsub/gh-stack/docs
Jun 24, 2026
Merged

ananthsub merged 2 commits into
mainfrom
ananthsub/gh-stack/docs

Conversation

@ananthsub

@ananthsub ananthsub commented Jun 16, 2026 •

Copy link
Copy Markdown
Contributor

Expands the Development Workflow section of the Development Setup page with a Stacked Pull Requests guide: prerequisites (including the OAuth-not-PAT requirement and the push-to-the-enabled-remote rule), creating and updating a stack, and a command reference. The concept and PR UI are deferred to GitHub's Stacked PRs overview.

Top of the stack — depends on #1616 (references the vendored gh-stack skill).

@copy-pr-bot

copy-pr-bot Bot commented Jun 16, 2026

Copy link
Copy Markdown

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

@github-actions

github-actions Bot commented Jun 16, 2026 •

Copy link
Copy Markdown
Contributor

🌿 Preview your docs: https://nvidia-preview-ananthsub-gh-stack-docs.docs.buildwithfern.com/nemo/gym

Here are the markdown pages you've updated:

@ananthsub
ananthsub requested a review from lbliii June 16, 2026 14:39
@ananthsub
ananthsub force-pushed the ananthsub/gh-stack/docs branch from d0f22f7 to 25cf785 Compare June 16, 2026 14:45
@ananthsub ananthsub changed the title docs: add stacked pull requests contributor guide docs: document stacked pull requests in development setup Jun 16, 2026
@ananthsub
ananthsub marked this pull request as ready for review June 16, 2026 16:10
@ananthsub
ananthsub force-pushed the ananthsub/gh-stack/docs branch from 25cf785 to bb82d20 Compare June 16, 2026 16:10
@copy-pr-bot

copy-pr-bot Bot commented Jun 16, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

lbliii added a commit that referenced this pull request Jun 16, 2026
Style guide pass on the **Stacked Pull Requests** guide added in #1617.
Six low-risk fixes against the NVIDIA documentation style guide:

- **Contractions removed** — `don't` → `do not`, `isn't` → `is not`
- **Headings title-cased** to match the page convention (`Create a
Stack`, `Update a Stack`, `Command Reference`)
- **Code example introduced with a complete sentence** in Prerequisites;
`v2.0+` → `v2.0 or later`
- **Symbol → word** in the command reference table: `Push + open PRs` →
`Push and open PRs`

Spaced em dashes were intentionally left as-is — they match the
repo-wide convention (27 doc files vs. 4).

Stacked on top of #1617.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Signed-off-by: Lawrence Lane <llane@nvidia.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
lbliii
lbliii previously approved these changes Jun 16, 2026
ananthsub pushed a commit that referenced this pull request Jun 23, 2026
Style guide pass on the **Stacked Pull Requests** guide added in #1617.
Six low-risk fixes against the NVIDIA documentation style guide:

- **Contractions removed** — `don't` → `do not`, `isn't` → `is not`
- **Headings title-cased** to match the page convention (`Create a
Stack`, `Update a Stack`, `Command Reference`)
- **Code example introduced with a complete sentence** in Prerequisites;
`v2.0+` → `v2.0 or later`
- **Symbol → word** in the command reference table: `Push + open PRs` →
`Push and open PRs`

Spaced em dashes were intentionally left as-is — they match the
repo-wide convention (27 doc files vs. 4).

Stacked on top of #1617.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Signed-off-by: Lawrence Lane <llane@nvidia.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
@ananthsub
ananthsub force-pushed the ananthsub/gh-stack/docs branch from fe6ce10 to 4cb7be8 Compare June 23, 2026 13:08
Base automatically changed from ananthsub/gh-stack/skill to main June 23, 2026 13:10
ananthsub added a commit that referenced this pull request Jun 23, 2026
Vendors the [github/gh-stack](https://github.com/github/gh-stack) agent skill into `.claude/skills/gh-stack/` so coding agents working in this repo know how to drive stacked PRs (create, push, rebase, sync, navigate) non-interactively.

NeMo Gym now uses [GitHub Stacked PRs](https://github.github.com/gh-stack/) for larger changes. Installed
via `gh skill install github/gh-stack gh-stack`.

Bottom of a 2-PR stack; the contributor guide that references this skill
follows in #1617.

Signed-off-by: Ananth Subramaniam <ansubramania@nvidia.com>
ananthsub pushed a commit that referenced this pull request Jun 23, 2026
Style guide pass on the **Stacked Pull Requests** guide added in #1617.
Six low-risk fixes against the NVIDIA documentation style guide:

- **Contractions removed** — `don't` → `do not`, `isn't` → `is not`
- **Headings title-cased** to match the page convention (`Create a
Stack`, `Update a Stack`, `Command Reference`)
- **Code example introduced with a complete sentence** in Prerequisites;
`v2.0+` → `v2.0 or later`
- **Symbol → word** in the command reference table: `Push + open PRs` →
`Push and open PRs`

Spaced em dashes were intentionally left as-is — they match the
repo-wide convention (27 doc files vs. 4).

Stacked on top of #1617.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Signed-off-by: Lawrence Lane <llane@nvidia.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
@ananthsub
ananthsub force-pushed the ananthsub/gh-stack/docs branch from 4cb7be8 to 37f2466 Compare June 23, 2026 13:10
@ananthsub
ananthsub requested a review from lbliii June 23, 2026 13:10
ananthsub and others added 2 commits June 24, 2026 00:33
Signed-off-by: Ananth Subramaniam <ansubramania@nvidia.com>
Style guide pass on the **Stacked Pull Requests** guide added in #1617.
Six low-risk fixes against the NVIDIA documentation style guide:

- **Contractions removed** — `don't` → `do not`, `isn't` → `is not`
- **Headings title-cased** to match the page convention (`Create a
Stack`, `Update a Stack`, `Command Reference`)
- **Code example introduced with a complete sentence** in Prerequisites;
`v2.0+` → `v2.0 or later`
- **Symbol → word** in the command reference table: `Push + open PRs` →
`Push and open PRs`

Spaced em dashes were intentionally left as-is — they match the
repo-wide convention (27 doc files vs. 4).

Stacked on top of #1617.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Signed-off-by: Lawrence Lane <llane@nvidia.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
@ananthsub
ananthsub force-pushed the ananthsub/gh-stack/docs branch from 37f2466 to 3390ce0 Compare June 24, 2026 07:33
@ananthsub ananthsub added the documentation Improvements to documentation label Jun 24, 2026
@ananthsub
ananthsub merged commit 191eee3 into main Jun 24, 2026
15 checks passed
@ananthsub
ananthsub deleted the ananthsub/gh-stack/docs branch June 24, 2026 07:34
ritaneves pushed a commit that referenced this pull request Jun 25, 2026
Vendors the [github/gh-stack](https://github.com/github/gh-stack) agent skill into `.claude/skills/gh-stack/` so coding agents working in this repo know how to drive stacked PRs (create, push, rebase, sync, navigate) non-interactively.

NeMo Gym now uses [GitHub Stacked PRs](https://github.github.com/gh-stack/) for larger changes. Installed
via `gh skill install github/gh-stack gh-stack`.

Bottom of a 2-PR stack; the contributor guide that references this skill
follows in #1617.

Signed-off-by: Ananth Subramaniam <ansubramania@nvidia.com>
Signed-off-by: Rita Fernandes Neves <rfernandesne@nvidia.com>
ritaneves pushed a commit that referenced this pull request Jun 25, 2026
Expands the **Development Workflow** section of the Development Setup
page with a Stacked Pull Requests guide: prerequisites (including the
OAuth-not-PAT requirement and the push-to-the-enabled-remote rule),
creating and updating a stack, and a command reference. The concept and
PR UI are deferred to GitHub's [Stacked PRs
overview](https://github.github.com/gh-stack/).

Top of the stack — depends on #1616 (references the vendored `gh-stack`
skill).

---------

Signed-off-by: Ananth Subramaniam <ansubramania@nvidia.com>
Signed-off-by: Lawrence Lane <llane@nvidia.com>
Co-authored-by: Lawrence Lane <llane@nvidia.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Rita Fernandes Neves <rfernandesne@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants