From b6d92dc1b8113744a2e9caa9a3e18403a7edeb08 Mon Sep 17 00:00:00 2001
From: decentral1se <cellarspoon@riseup.net>
Date: Tue, 13 Dec 2022 16:34:16 +0100
Subject: [PATCH] docs: migration guide
---
docs/abra/upgrade.md | 14 ++++++++++++++
1 file changed, 14 insertions(+)
diff --git a/docs/abra/upgrade.md b/docs/abra/upgrade.md
index ad83baed..a71d2c36 100644
--- a/docs/abra/upgrade.md
+++ b/docs/abra/upgrade.md
@@ -18,6 +18,20 @@ abra upgrade --rc
## Migration guides
+### `0.5.x-beta` -> `0.6.x-beta`
+
+- Using `{{ .Domain }}` in recipe `.envrc.sample` files went away because it
+ was portable enough. We revert to replacing e.g `gitea.example.com` with the
+ domain. See
+ [`8fad34e`](https://git.coopcloud.tech/coop-cloud/abra/commit/8fad34e) for
+ more.
+
+- If your `abra.sh` scripts depend on `/bin/sh` and `/bin/bash` is available in
+ the container then `/bin/bash` will be used from now on. `/bin/sh` is only
+ now used if `/bin/bash` is not available. See
+ [`7f745ff`](https://git.coopcloud.tech/coop-cloud/abra/commit/7f745ff) for
+ more.
+
### `v0.4.x` -> `v0.5.x`
- The only breaking change was making `abra` understand that the JSON dump for the recipes listing lives on [recipes.coopcloud.tech/recipes.json](https://recipes.coopcloud.tech) instead of [recipes.coopcloud.tech](https://recipes.coopcloud.tech).