diff --git a/docs/update_workflow.md b/docs/update_workflow.md
new file mode 100644
index 0000000..40af6b5
--- /dev/null
+++ b/docs/update_workflow.md
@@ -0,0 +1,10 @@
+# Version update
+
+1. Update version in `pyproject.toml`
+2. Update version in `uv.lock`
+3. Update version in `src/app.py`
+4. Update `CHANGES.md`. Take info from git log
+5. Update `README.md`
+6. Commit changes
+7. Tag release
+8. Push changes