From 44358647797a67cbd85794c177a8944f4603e69a Mon Sep 17 00:00:00 2001
From: maren-bunk <maren@bunk.computer>
Date: Wed, 23 Sep 2026 07:04:39 -0400
Subject: [PATCH] Update faq.rst to clarify how to deploy tagged releases

---
 doc/source/faq.rst | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/doc/source/faq.rst b/doc/source/faq.rst
index 2d7dc954..2ba1671d 100644
--- a/doc/source/faq.rst
+++ b/doc/source/faq.rst
@@ -63,9 +63,17 @@ and run the following commands:
        scripts/initenv.sh
        scripts/cmdeploy run
 
-If you don't want the latest development version,
-but a specific tagged release like `1.10.0 <https://github.com/chatmail/relay/releases/tag/1.10.0>`_,
-run ``git pull origin 1.10.0`` instead.
+To upgrade to the latest tag,
+``cd`` into your local checkout of https://github.com/chatmail/relay/
+and run the following commands:
+
+   ::
+
+       git fetch --tags
+       latestTag=$(git describe --tags "$(git rev-list --tags --max-count=1)")
+       git checkout $latestTag
+       scripts/initenv.sh
+       scripts/cmdeploy run
 
 If you made local changes for your setup,
 they will be reapplied as long as they don't conflict with the upgrade.