Obervations hopefully accurate as of 2026-07-31. Some comments written from the perspective of looking to use this in Nixpkgs.
- You can't make stacked PRs from a fork, which sadly makes this feature basically only useful for like one or two committers.
- github/gh-stack#18
- (Note: In Nixpkgs we call those with permission to merge pull requests "committers". Think "commit bit".)
- The docs around https://github.github.com/gh-stack/introduction/overview/ are better than the stacked PR docs on docs.github.com
- Stacked pull requests are an extension of the existing feature where you can have a pull request
foo -> main, and anotherbar -> foo, and when the first gets merged the latter automatically retargets tobar -> main. This is also how you can manually create stackable pull requests. - Stacked pull requests are only considered to be "consistent" if the history is strictly linear. In other words each base branch in the stack must be an ancestor of the head branch.