README.branch: Describe purpose of branch.branden-2023-05-06

1 files changed, 32 insertions, 0 deletions

diff --git a/README.branch b/README.branch
new file mode 100644
index 000000000..7dc6bff21
--- /dev/null
+++ b/README.branch
@@ -0,0 +1,32 @@
+This branch is a staging ground for commits intended for cherry-picking
+to the master branch in preparation for the tagging of groff 1.23.0.rc4.
+
+The commits are not in chronological order of development, but in a
+subjective ordering of risk to release stability, with the earlier
+commits being less risky and the more recent ones more so.  The idea
+is to make it easy to merge many of them, or to simply choose a point
+within the series for merge and tagging as rc4.
+
+I'm happy to perform merge or cherry-pick operations as directed by
+Bertrand, who as maintainer may then perform the tag operation and
+distribution archive generation.
+
+Here are the risk categories as I conceive them.  As you read down a
+plain "git log" command from this branch, you will see the commits
+appear in the following order.
+
+Level 6: Changes to installed, compiled code.
+Level 5: Changes to installed macro packages.
+Level 4: Changes to installed scripts.
+Level 3: Changes to build scripts.
+Level 2: Changes to test scripts.
+Level 1: Changes to documentation.
+
+The branch point from the master branch is at the bottom.
+
+(As of this writing, level 1 changes continue to be committed directly
+to the master branch.)
+
+The commit creating this file should of course not be merged.
+
+--GBR