From: Stefan Kangas <stefankangas@gmail.com>
Date: Sat, 22 Oct 2022 10:15:49 +0000 (+0200)
Subject: * admin/notes/repo: Document feature and scratch branches.
X-Git-Tag: emacs-29.0.90~1616^2~504
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=636322cfe06daef07d8fe8a7650fbe27370aea22;p=emacs.git

* admin/notes/repo: Document feature and scratch branches.
---

diff --git a/admin/notes/repo b/admin/notes/repo
index c2d7f993a02..2185c5a0036 100644
--- a/admin/notes/repo
+++ b/admin/notes/repo
@@ -42,6 +42,24 @@ yet another fun excursion into the exciting world of version control.
 
 https://lists.gnu.org/r/emacs-devel/2010-04/msg00086.html
 
+* feature and scratch branches
+
+Besides the master branch, which is where development takes place, and
+the "emacs-NN" release branches, we also have branches whose names
+start with "scratch/" and "feature/".  The "feature/" prefix is used
+for feature branches that are intended to live for some time, while
+"scratch/" is for one-off throw-away-after-use branches.
+
+We do not intend to "git merge" from scratch branches, so force-pushes
+are tolerated, as well as commits with poor style, incomplete commit
+messages, etc.
+
+We do expect to "git merge" from feature branches so: no force push,
+and no commits that don't have a proper commit message.
+
+Automatic tests are run for feature/* branches on EMBA.
+See: https://emba.gnu.org/emacs/emacs/-/pipelines
+
 * Installing changes from gnulib
 
 Some of the files in Emacs are copied from gnulib.  To synchronize