From 01db789d429e60196dcb271e32d821506437fe73 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Fri, 7 Jul 2023 10:56:35 +0200
Subject: [PATCH] Improve release documentation

---
 docs/developer.md                 |  8 ++++++-
 docs/includes/release_template.md | 37 +++++++++++++++++++++++++++++++
 2 files changed, 44 insertions(+), 1 deletion(-)
 create mode 100644 docs/includes/release_template.md

diff --git a/docs/developer.md b/docs/developer.md
index 2782f0117..4784e5352 100644
--- a/docs/developer.md
+++ b/docs/developer.md
@@ -453,7 +453,13 @@ Once the PR against stable is merged (best right after merging):
 * Use the button "Draft a new release" in the Github UI (subsection releases).
 * Use the version-number specified as tag.
 * Use "stable" as reference (this step comes after the above PR is merged).
-* Use the above changelog as release comment (as codeblock)
+* Use the above changelog as release comment (as codeblock).
+* Use the below snippet for the new release
+
+??? Tip "Release template"
+    ````
+    --8<-- "includes/release_template.md"
+    ````
 
 ## Releases
 
diff --git a/docs/includes/release_template.md b/docs/includes/release_template.md
new file mode 100644
index 000000000..87a3564da
--- /dev/null
+++ b/docs/includes/release_template.md
@@ -0,0 +1,37 @@
+## Highlighted changes
+
+- ...
+
+### How to update
+
+As always, you can update your bot using one of the following commands:
+
+#### docker-compose
+
+```bash
+docker-compose pull
+docker-compose up -d
+```
+
+#### Installation via setup script
+
+```
+# Deactivate venv and run 
+./setup.sh --update
+```
+
+#### Plain native installation
+
+```
+git pull
+pip install -U -r requirements.txt
+```
+
+<details>
+<summary>Expand full changelog</summary>
+
+```
+<Paste your changelog here>
+```
+
+</details>