From 45418aced91ddf2793dd46d79ab68393eb21fb82 Mon Sep 17 00:00:00 2001
From: Leonardo Schwarz <leonardo.schwarz@fgcz.ethz.ch>
Date: Tue, 13 Aug 2024 17:32:40 +0200
Subject: [PATCH] doc: add some useful information

---
 docs/contribute.md | 12 ++++++++++++
 docs/index.md      |  8 ++++++++
 2 files changed, 20 insertions(+)

diff --git a/docs/contribute.md b/docs/contribute.md
index dffad086..d8027307 100644
--- a/docs/contribute.md
+++ b/docs/contribute.md
@@ -29,3 +29,15 @@ mkdocs serve
 # To publish after changes
 mkdocs gh-deploy
 ```
+
+## Release
+
+To create a release, increase the version in `pyproject.toml`, prepare `changelog.md`,
+commit everything and run `release.py`. This script will
+
+- Create a tag and push it to GitHub
+- Merge the changes to the `stable` branch and push it to GitHub
+- Build the documentation and push it to GitHub Pages
+
+The only manual step that remains is creating a release on GitHub.
+To do so, you can paste the changelog section of the release and create a new release on GitHub using the tag that was created.
diff --git a/docs/index.md b/docs/index.md
index c0fa88e9..5af67cc7 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -31,6 +31,14 @@ dependencies = [
 ]
 ```
 
+## Updating
+
+If you installed with `pipx`, you can update the package to the most recent release with the following command:
+
+```bash
+pipx upgrade bfabric
+```
+
 ## Configuration
 
 Create a file as follows: (note: the password is not your login password, but the web service password available on your profile page)