[llvm] [docs][GitHub] Document alternative approach to stacked PRs (PR #132424)

Andrzej Warzyński via llvm-commits llvm-commits at lists.llvm.org
Fri Mar 21 11:35:24 PDT 2025


https://github.com/banach-space updated https://github.com/llvm/llvm-project/pull/132424

>From be8759dff108486851a5e1972499c7849833624b Mon Sep 17 00:00:00 2001
From: Andrzej Warzynski <andrzej.warzynski at arm.com>
Date: Fri, 21 Mar 2025 16:58:14 +0000
Subject: [PATCH] [docs][GitHub] Document alternative approach to stacked PRs

---
 llvm/docs/GitHub.rst | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/llvm/docs/GitHub.rst b/llvm/docs/GitHub.rst
index 03cf2251f955e..8b87e47bda2a8 100644
--- a/llvm/docs/GitHub.rst
+++ b/llvm/docs/GitHub.rst
@@ -29,8 +29,23 @@ intended to be able to support "stacked" pull-request. Do not create any branche
 llvm/llvm-project repository otherwise, please use a fork (see below). User branches that
 aren't associated with a pull-request **will be deleted**.
 
+Stacked Pull Requests
+=====================
+
+GitHub does not natively support stacked pull requests. There are two common
+alternatives:
+
+  * Add a note in your PR summary indicating that your patch is part of a
+    series or depends on another PR (e.g., “Depends on #123456”). It also helps
+    to highlight which commits belong to other PRs, so reviewers can focus only
+    on the relevant changes.
+  * Use Graphite (described below), a tool that supports stacked PR workflows.
+
+Both approaches help streamline the review process. Choose the one that works
+best for you.
+
 Using Graphite for stacked Pull Requests
-========================================
+----------------------------------------
 
 `Graphite <https://app.graphite.dev/>`_ is a stacked pull request tool supported
 by the LLVM repo (the other being `reviewable.io <https://reviewable.io>`_).



More information about the llvm-commits mailing list