From c74beed3c8bf9fa34a8a96c1090a9a7b1fedd487 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  | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++
 build.zig.zon |  2 +-
 2 files changed, 62 insertions(+), 1 deletion(-)
 create mode 100644 RELEASING.md

diff --git a/RELEASING.md b/RELEASING.md
new file mode 100644
index 0000000..fb01a42
--- /dev/null
+++ b/RELEASING.md
@@ -0,0 +1,61 @@
+# Releasing
+
+NullTickets 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). It builds binaries for supported platforms and publishes a GitHub Release.
+
+## 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 GitHub Release publishing.
+
+## Notes
+
+- Pull requests to `main` run CI for Linux, macOS, and Windows.
+- 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 c3e1988..1b11d08 100644
--- a/build.zig.zon
+++ b/build.zig.zon
@@ -1,6 +1,6 @@
 .{
     .name = .nulltickets,
-    .version = "2026.3.2",
+    .version = "2026.5.29",
     .fingerprint = 0x8d7cc7c0ca874218,
     .minimum_zig_version = "0.16.0",
     .dependencies = .{