From e2d3562dea316b1dcd29e104d51f54e5dd1461a2 Mon Sep 17 00:00:00 2001
From: Igor Somov <donprusne@gmail.com>
Date: Fri, 29 May 2026 10:18:55 -0300
Subject: [PATCH] v2026.5.29

---
 RELEASING.md  | 62 +++++++++++++++++++++++++++++++++++++++++++++++++++
 build.zig.zon |  2 +-
 2 files changed, 63 insertions(+), 1 deletion(-)
 create mode 100644 RELEASING.md

diff --git a/RELEASING.md b/RELEASING.md
new file mode 100644
index 0000000..d3ac086
--- /dev/null
+++ b/RELEASING.md
@@ -0,0 +1,62 @@
+# Releasing
+
+NullBoiler uses [CalVer](https://calver.org/) with the format `YYYY.M.D` (for example, `v2026.5.29`).
+
+Pushing a tag matching `v*` triggers the [Release workflow](.github/workflows/release.yml), which calls the shared `nullclaw/nullbuilder` Zig release workflow for binary artifacts. The same workflow also publishes Docker images through the repository release pipeline.
+
+## Steps
+
+1. **Checkout and update `main`**
+
+   ```bash
+   git checkout main
+   git pull origin main
+   ```
+
+2. **Create a release branch**
+
+   ```bash
+   git checkout -b release/vYYYY.M.D
+   ```
+
+3. **Bump the version in `build.zig.zon`**
+
+   Update the `.version` field to match today's date:
+
+   ```diff
+   - .version = "2026.3.2",
+   + .version = "2026.5.29",
+   ```
+
+4. **Commit the version bump**
+
+   ```bash
+   git add build.zig.zon
+   git commit -m "vYYYY.M.D"
+   ```
+
+5. **Push the branch and create a PR**
+
+   ```bash
+   git push origin release/vYYYY.M.D
+   gh pr create --title "vYYYY.M.D" --body "Version bump for vYYYY.M.D release."
+   ```
+
+6. **Merge the PR** or get it reviewed and merged.
+
+7. **Tag the release on `main`**
+
+   ```bash
+   git checkout main
+   git pull origin main
+   git tag vYYYY.M.D
+   git push origin vYYYY.M.D
+   ```
+
+   The tag push triggers the release build and release Docker publishing.
+
+## Notes
+
+- Pull requests to `main` run the CI workflow through `nullclaw/nullbuilder`.
+- A manual release workflow dispatch requires an existing release tag, for example `v2026.5.29`.
+- If multiple releases happen on the same day, append a patch number, for example `v2026.5.29.1`.
diff --git a/build.zig.zon b/build.zig.zon
index 13e89ce..4108290 100644
--- a/build.zig.zon
+++ b/build.zig.zon
@@ -1,7 +1,7 @@
 .{
     .name = .nullboiler,
     .fingerprint = 0xa2fe02b8f872821f,
-    .version = "2026.3.2",
+    .version = "2026.5.29",
     .minimum_zig_version = "0.16.0",
     .dependencies = .{
         .sqlite3 = .{