From 7d9556681dc9aa23f6aba95e542e1c6e6aa01506 Mon Sep 17 00:00:00 2001
From: Emil Velikov
Date: Wed, 7 Nov 2018 16:02:59 +0000
Subject: [PATCH] docs: document the staging branch and add reference to it
A while back we agreed that having a live/staging branch is beneficial.
Sadly we forgot to document that, so here is my first attempt.
Document the caveat that the branch history is not stable.
CC: Andres Gomez
CC: Dylan Baker
Signed-off-by: Emil Velikov
Reviewed-by: Juan A. Suarez
---
docs/releasing.html | 20 ++++++++++++++++++++
docs/submittingpatches.html | 3 +++
2 files changed, 23 insertions(+)
diff --git a/docs/releasing.html b/docs/releasing.html
index 87590b19301..e4c770f9186 100644
--- a/docs/releasing.html
+++ b/docs/releasing.html
@@ -21,6 +21,7 @@
Overview
Release schedule
Cherry-pick and test
+Staging branch
Making a branchpoint
Pre-release announcement
Making a new release
@@ -212,6 +213,25 @@ system and making some every day's use until the release may be a good
idea too.
+Staging branch
+
+
+A live branch, which contains the currently merge/rejected patches is available
+in the main repository under staging/X.Y
. For example:
+
+
+ staging/18.1 - WIP branch for the 18.1 series
+ staging/18.2 - WIP branch for the 18.2 series
+
+
+
+Notes:
+
+
+- People are encouraged to test the staging branch and report regressions.
+- The branch history is not stable and it will be rebased,
+
+
Making a branchpoint
diff --git a/docs/submittingpatches.html b/docs/submittingpatches.html
index b84f01c3b37..3f97c941aa5 100644
--- a/docs/submittingpatches.html
+++ b/docs/submittingpatches.html
@@ -253,6 +253,9 @@ If you are not the author of the original patch, please Cc: them in your
nomination request.
+
+The current patch status can be observed in the staging branch.
+
The stable tag
--
2.30.2