debian/README.source: add rationale

diff --git a/debian/README.source b/debian/README.source
index 8efb41222b13281f1a310eed2d99544a66cdf055..728f4628bbfadb5485fe4cd5dcece6c73cbec545 100644 (file)
--- a/debian/README.source
+++ b/debian/README.source
@@ -1,5 +1,22 @@
-We use git-dpm, gbp-dch and dgit in combination.
-We expect to replace git-dpm with git-debrebase at some point.
+We use git-dpm, gbp-dch and dgit in combination.  We expect to replace
+git-dpm with git-debrebase at some point.
+
+Rationale
+=========
+
+The revision control arrangment (branching, etc.) has had to
+accommodate both source-level package versioning (i.e. emacs25,
+emacs26, ...) and splitting the upstream code into two source packages
+for each release (i.e. emacs and emacs-non-dfsg), but the emacs
+packages have been unversioned, so the former doesn't apply right now.
+In any case, that's why all the refs include the source package name.
+
+The refs are prefixed with deb/ to support packaging work in a
+repository that might also be used for normal upstream development
+(say you're in both roles) so conflicts will be unlikely.
+
+Finally, the refs include the release name to ease/normalize work
+across releases, backports, etc.
 
 Worktrees
 =========
@@ -151,4 +168,4 @@ The repository layout, DFSG splitting and this workflow were developed mostly
 by Rob Browning.  Sean Whitton updated the workflow in a few respects, adding
 the use of worktrees, and prepared and published this documentation.
 
- -- Sean Whitton <spwhitton@spwhitton.name>, Sat, 27 Apr 2024 14:11:39 +0100
+ -- Rob Browning <rlb@defaultvalue.org>, Wed, 15 May 2024 00:45:46 -0500