Thread (2 messages) 2 messages, 2 authors, 2023-07-27

Re: [PATCH 7/5] SubmittingPatches: explain why 'next' and above are inappropriate base

From: Linus Arver <hidden>
Date: 2023-07-27 19:26:37

Junio C Hamano [off-list ref] writes:
quoted hunk ↗ jump to hunk
diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches
index d1e3783978..559c02c90c 100644
--- a/Documentation/SubmittingPatches
+++ b/Documentation/SubmittingPatches
@@ -57,10 +57,14 @@ latest HEAD commit of `maint` or `master` based on the following cases:
 
 This also means that `next` or `seen` are inappropriate starting points
 for your work, if you want your work to have a realistic chance of
-graduating to `master`.  They are simply not designed to provide a
-stable base for new work, because they are (by design) frequently
-re-integrated with incoming patches on the mailing list and force-pushed
-to replace previous versions of these branches.
+graduating to `master`.  They are simply not designed to be used as a
+base for new work; they are only there to make sure that topics in
+flight work well together. This is why both `next` and `seen` are
+frequently re-integrated with incoming patches on the mailing list and
+force-pushed to replace previous versions of themselves. A topic that is
+literally built on top of `next` cannot be merged to 'master' without
s/'master'/`master`

(Sorry I missed this in my patch.)
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help