2 files changed, 28 insertions(+), 0 deletions(-)

M index.md
A release-process.md

@@ 8,6 8,7 @@ tool. It is an ordinary git repository, so improvements are just a push away.
 
 - [Getting started](getting-started.md) — install hello-hut and say hello
 - [Frequently asked questions](faq.md)
+- [Release process](release-process.md) — how a version is tagged and announced
 
 ## Elsewhere
 

@@ 0,0 1,27 @@
+# Release process
+
+Releases are cut from `main` by a maintainer.
+
+1. Update `CHANGELOG.md` and the version in `src/hello_hut/__init__.py`.
+2. Commit as `Release X.Y.Z` and create an annotated tag:
+
+   ```sh
+   git tag -a vX.Y.Z -m "hello-hut X.Y.Z"
+   git push origin main vX.Y.Z
+   ```
+
+3. Build the tarball and attach it to the tag on git.hut.md:
+
+   ```sh
+   git archive --format=tar.gz --prefix=hello-hut-X.Y.Z/ vX.Y.Z > hello-hut-X.Y.Z.tar.gz
+   ```
+
+4. Announce it on
+   [hello-hut-announce](https://lists.hut.md/~reviewer/hello-hut-announce).
+
+| Version | Date | Highlights |
+| --- | --- | --- |
+| 0.2.0 | 2026-09-15 | `--count`, `--color`, `--format json`, completions |
+| 0.1.0 | 2026-05-04 | First release |
+
+Back to the [index](index.md).