From 5c97e04248f4b89086654a294a4f4f55f5e2f446 Mon Sep 17 00:00:00 2001
From: Ruben Hensen <ruben.hensen@protonmail.com>
Date: Mon, 30 Mar 2026 09:44:10 +0200
Subject: [PATCH] add CI pipeline explanation

---
 .github/workflows/ci.yml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 3fc7fd8..750b58f 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -1,4 +1,13 @@
 name: CI
+#
+# Pipeline overview
+# =================
+#
+# Release-plz and Docker delivery are combined in one workflow because
+# GITHUB_TOKEN-created tags do not trigger new workflow runs. This means a
+# versioned Docker image must be built in the same run that release-plz
+# creates the release, using its job outputs to pass the version through.
+#
 
 on:
   push: