From b9511a8ded7788ba30e1f0d5855afcdfe19224a6 Mon Sep 17 00:00:00 2001
From: Salamandar <6552989+Salamandar@users.noreply.github.com>
Date: Mon, 13 May 2024 10:17:34 +0200
Subject: [PATCH] Reword post-upgrade doc for clarity.

Co-authored-by: Alexandre Aubin <4533074+alexAubin@users.noreply.github.com>
---
 doc/PRE_UPGRADE.d/1.2.8.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/doc/PRE_UPGRADE.d/1.2.8.md b/doc/PRE_UPGRADE.d/1.2.8.md
index 4986dea..4bd9780 100644
--- a/doc/PRE_UPGRADE.d/1.2.8.md
+++ b/doc/PRE_UPGRADE.d/1.2.8.md
@@ -1,12 +1,12 @@
 This app has gone through a major revamp!
 
-If you have multiple instances of this app, one upgrade will break all instances. You need to
-upgrade all apps. This is the last time it happens.
+The upgrade should be mainly transparent to you. However, if you have multiple instances of this app, one upgrade will break other instances and you'll need to upgrade every instance of borg installed on your server.
 
 Also, developer aren't flawless and we might have missed something during our tests.
-Please, PLEASE, check in a few days that backups are being done properly.
 
-If you want to manually check backups, run this:
+We **highly** recommend to check that your backups are still being created after the upgrade.
+
+You can manually trigger borg backups from command line with:
 
 ```bash
 systemctl start borg
@@ -18,6 +18,6 @@ Or, for a single app, for example Nextcloud:
 sudo yunohost backup create --apps nextcloud --methods borg_app
 ```
 
-If you find *any* issue or have a doubt, feel free to contact the devs on Github or Matrix.
+If you find *any* issue or have a doubt, feel free to contact the YunoHost team on Github or Matrix.
 
 Backups are important. In any case, check your backups regularly.