diff --git a/doc/DISCLAIMER.md b/doc/DISCLAIMER.md
index 81459ab..3873129 100644
--- a/doc/DISCLAIMER.md
+++ b/doc/DISCLAIMER.md
@@ -8,6 +8,22 @@ There is already a commercial software called "Garradin" in Australia, which doe
 You can now upgrade Garradin with Paheko ! 
 Don't stay with this repository, it will be no more supported.
 
-Take a Look at the Paheko repository and read the instructions how to migrate your application Garradin to Paheko: 
+Read the instructions how to migrate your application Garradin to Paheko: 
 
-https://github.com/YunoHost-Apps/paheko_ynh/tree/garradin-migration
+### Migrate from Garradin
+
+Process the migration from Garradin to Paheko. For that, you will have to upgrade your Garradin application with this repository. This can only be done from the command-line interface - e.g. through SSH. Once you're connected, you simply have to execute the following:
+
+```bash
+sudo yunohost app upgrade garradin -u https://github.com/YunoHost-Apps/paheko_ynh/tree/garradin-migration --debug
+```
+
+The --debug option will let you see the full output. If you encounter any issue, please report it aand paste the logs.
+
+**Important**: After the migration, you'll have to wait a couple of minutes (at most 3 minutes) before you can start using Paheko.
+
+Once the migration is done, you should then upgrade to new release of Paheko.
+
+```bash
+sudo yunohost app upgrade paheko
+```
diff --git a/doc/DISCLAIMER_fr.md b/doc/DISCLAIMER_fr.md
index d7f0a3f..da27ba4 100644
--- a/doc/DISCLAIMER_fr.md
+++ b/doc/DISCLAIMER_fr.md
@@ -6,6 +6,22 @@ Il existe déjà un logiciel commercial appelé « Garradin » en Australie, qui
 
 Vous pouvez dès maintenant mettre à niveau Garradin avec Paheko ! 
 
-Ne continuez pas avec ce dépôt, il ne sera plus maintenu. Rendez-vous sur le dépôt Paheko et lisez les instructions pour migrer votre application Garradin vers Paheko :
+Ne continuez pas avec ce dépôt, il ne sera plus maintenu. Lisez ces instructions pour migrer votre application Garradin vers Paheko :
 
-https://github.com/YunoHost-Apps/paheko_ynh/tree/garradin-migration
+### Migrer depuis Garradin
+
+Ce paquet supporte la migration de Garradin vers Paheko. Pour ce faire, vous allez devoir mettre à jour l'application Garradin à l'aide de ce dépôt. Cette opération ne peut se faire seulement depuis une interface en ligne de commande, autrement dit en SSH. Une fois connecté/e, vous devez simplement lancer la commande suivante :
+
+```bash
+sudo yunohost app upgrade garradin -u https://github.com/YunoHost-Apps/paheko_ynh/tree/garradin-migration --debug
+```
+
+L'option debug vous permet de voir l'entièreté du journal d'installation. Si vous rencontrez des difficultés, merci de créer un ticket en collant le journal d'erreur.
+
+**Important** : Après la migration, veuillez attendre quelques instants (maximum 3 minutes) avant de commencer à utiliser Paheko.
+
+Une fois la migration terminée, vous pourrez mettre à jour avec la dernière version stable de Paheko
+
+```
+sudo yunohost app upgrade paheko
+```