From acc5fdc2f32563b0df68d93c7f4998bc03fa8dc4 Mon Sep 17 00:00:00 2001
From: Brian Vargyas <brianv@vargyas.net>
Date: Fri, 4 Sep 2026 01:53:23 +0000
Subject: [PATCH] docs: how to cut a release

---
 README.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.md b/README.md
index 0b1a457..2395a73 100644
--- a/README.md
+++ b/README.md
@@ -79,6 +79,17 @@ Architecture and the reasoning behind it: [docs/ARCHITECTURE.md](docs/ARCHITECTU
 Versions and what changed in each: [CHANGELOG.md](CHANGELOG.md). The running
 version is in the page footer and at `GET /healthz`.
 
+To cut a release: move the `[Unreleased]` notes in `CHANGELOG.md` under a new
+`## [x.y.z] - date` heading, set the same version in `package.json`, commit, then tag
+and publish the Gitea release with the changelog section as its notes:
+
+```bash
+git tag -a vx.y.z -m "Courtside x.y.z" && git push origin --tags
+# Gitea → Releases → Draft a release on tag vx.y.z, or POST /api/v1/repos/bkvargyas/courtside/releases
+```
+
+A push to `main` deploys; the tag and release record which commit each version was.
+
 ## License
 
 MIT. See [LICENSE](LICENSE).