From 5aff417cacb2612d4dce1c23f1cb69d9cf89b7b9 Mon Sep 17 00:00:00 2001
From: Robert Hensing <robert@roberthensing.nl>
Date: Tue, 13 Jan 2026 17:39:15 +0100
Subject: [PATCH] Document release branch workflow

---
 doc/maintainers/release.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/maintainers/release.md b/doc/maintainers/release.md
index 3b0f03b..1555ac0 100644
--- a/doc/maintainers/release.md
+++ b/doc/maintainers/release.md
@@ -3,6 +3,10 @@
 This project uses simple tags, that trigger a release of all crates using Hercules CI.
 See [HCI Effects cargo publish workflow].
 
+## Release branch
+
+Create a `release` branch and PR for release preparation. This allows CI to validate the release before tagging.
+
 ## Before tagging
 
 - Update `CHANGELOG.md`:
@@ -12,6 +16,9 @@ See [HCI Effects cargo publish workflow].
 ## After tagging
 
 - Add a new Unreleased section to `CHANGELOG.md`
+- Merge the release PR
+
+---
 
 Dissatisfied with the coarse grained release process? Complain to @roberth and he'll get it done for you.