diff --git a/README-FR.md b/README-FR.md
index 45d43b73ecba7195399c8f871587342abc547df8..2de31c8a3f55ffd3d1747498075fb42976f11639 100644
--- a/README-FR.md
+++ b/README-FR.md
@@ -8,7 +8,7 @@
[](https://github.com/LydraFr/ansible-yunohost)
[](https://github.com/LydraFr/ansible-yunohost)
- Collection Ansible - lydra.yunohost
+ Collection Ansible - `lydra.yunohost`
[🇬🇧 English version](README.md)
@@ -17,22 +17,18 @@ Comme il s'agit d'une collection indépendante, elle peut être publiée selon s
## Prérequis
-------------
-
Votre serveur doit être basé sur du Debian Buster et Yunohost ne doit pas déjà être installé.
## Contenu de la collection
### Rôles
-- [`lydra.yunohost.ynh_setup`](roles/ynh_setup/README-FR.md) : Ce rôle prépare les serveurs à base de Debian-Buster à exécuter Yunohost. Il configure Yunohost avec ses paramètres initiaux et les domaines, utilisateurs et applications de votre choix.
-- [`lydra.yunohost.ynh_apps`](roles/ynh_apps/README-FR.md): Ce rôle installe les applications Yunohost de votre choix et peut également lancer des tâches de post-installation.
+- [`lydra.yunohost.ynh_setup`](roles/ynh_setup/README-FR.md) : Ce rôle prépare les serveurs à base de Debian-Buster à exécuter Yunohost. Il configure Yunohost avec ses paramètres initiaux, les domaines et les utilisateurs de votre choix.
+- [`lydra.yunohost.ynh_apps`](roles/ynh_apps/README-FR.md): Ce rôle installe les applications Yunohost de votre choix et peut également les configurer grâce aux tâches de post-installation.
- [`lydra.yunohost.ynh_config`](roles/ynh_config/README-FR.md) : Ce rôle gère la configuration de différents services de Yunohost (relais SMTP, mises à jour automatiques).
- [`lydra.yunohost.ynh_backup`](roles/ynh_backup/README-FR.md) : Ce rôle gère la configuration des sauvegardes.
-### lydra.yunohost Tags du rôle
-
-------------
+### Tags du rôle
Ces tags sont applicables suivant les rôles.
@@ -50,8 +46,6 @@ Ces tags sont applicables suivant les rôles.
## License
-------------
-
[](https://choosealicense.com/licenses/gpl-3.0/)
**ansible-yunohost** est maintenu par [Lydra](https://lydra.fr/) et publié sous la licence GPL3.
diff --git a/README.md b/README.md
index 03cc4a174b607ff35df00e125b9ad723372181b2..0be9f001156b4a740b946ee2b094bfc1a743afaf 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@
[](https://github.com/LydraFr/ansible-yunohost)
[](https://github.com/LydraFr/ansible-yunohost)
-# Ansible Collection - lydra.yunohost
+# Ansible Collection - `lydra.yunohost`
[🇫🇷 French version](README-FR.md)
@@ -17,8 +17,6 @@ As this is an independent collection, it can be released on its own release cade
# Prerequisites
-------------
-
Your server must be Debian-Buster based and Yunohost shouldn't be already installed.
## Collection contents
@@ -30,9 +28,7 @@ Your server must be Debian-Buster based and Yunohost shouldn't be already instal
- [`lydra.yunohost.ynh_config`](roles/ynh_config/README.md): This role configures various Yunohost services (SMTP relay, auto updates).
- [`lydra.yunohost.ynh_backup`](roles/ynh_backup/README.md): This role manages the configuration of backups.
-## lydra.yunohost Role Tags
-
-------------
+## Role Tags
These tags are applicable to roles.
@@ -50,8 +46,6 @@ These tags are applicable to roles.
## License
-------------
-
[](https://choosealicense.com/licenses/gpl-3.0/)
**ansible-yunohost** is maintained by [Lydra](https://lydra.fr/) and released under the GPL3 license.
diff --git a/roles/ynh_backup/README-FR.md b/roles/ynh_backup/README-FR.md
index 88030c7ff7668368f338b4c2ab9de310934bf751..a39d4f85ad86a6cde2831c912409667e2bbb29a0 100644
--- a/roles/ynh_backup/README-FR.md
+++ b/roles/ynh_backup/README-FR.md
@@ -6,20 +6,14 @@ Sauvegardez [Yunohost](https://yunohost.org/#/) avec Ansible !
## Prérequis
-------------
-
Yunohost doit déjà être installé sur votre serveur.
## Variables du rôle
-------------
-
Les variables par défaut sont disponibles dans `default/main.yml` cependant il est possible de les surcharger selon vos besoins en ...
### Gestion des sauvegardes
-------------
-
```yml
ynh_backup:
scheduled: True
@@ -46,14 +40,10 @@ La tâche backup va permettre de sauvegarder les applications Yunohost ainsi que
## Dépendances
-------------
-
Aucune.
## Exemple de Playbook
-------------
-
```yml
---
- name: Configure Yunohost backups
@@ -67,8 +57,6 @@ Aucune.
## License
-------------
-
[](https://choosealicense.com/licenses/gpl-3.0/)
**ansible-yunohost** est maintenu par [Lydra](https://lydra.fr/) et publié sous la licence GPL3.
diff --git a/roles/ynh_backup/README.md b/roles/ynh_backup/README.md
index a6df15797dd1e0ec14983f638e1b6b86efac26ad..91e760ab2a2ba4abe2907d95bedcdd18fbbe9da2 100644
--- a/roles/ynh_backup/README.md
+++ b/roles/ynh_backup/README.md
@@ -6,20 +6,14 @@ Deploy [Yunohost](https://yunohost.org/#/) with Ansible!
## Requirements
-------------
-
Yunohost needs to be installed on your server.
## Role Variables
-------------
-
Default variables are available in `default/main.yml` however it is necessary to override them according to your needs for ...
### Backups management
-------------
-
```yml
ynh_backup:
scheduled: True
@@ -46,14 +40,10 @@ The backup task will allow to backup Yunohost applications and their data by set
## Dependencies
-------------
-
None.
## Example Playbook
-------------
-
```yml
---
- name: Configure Yunohost backups
@@ -67,8 +57,6 @@ None.
## License
-------------
-
[](https://choosealicense.com/licenses/gpl-3.0/)
**ansible-yunohost** is maintained by [Lydra](https://lydra.fr/) and released under the GPL3 license.
diff --git a/roles/ynh_backup/tasks/backup.yml b/roles/ynh_backup/tasks/backup.yml
index 3c071af3d46664ea4c8699bbbb2ad0b732acbbd9..a956b19367ea6df091ef8fa9ec84ba54570139fb 100644
--- a/roles/ynh_backup/tasks/backup.yml
+++ b/roles/ynh_backup/tasks/backup.yml
@@ -37,7 +37,7 @@
- backup
- cron
-- name: Create cron task to perform YNH backup
+- name: Create cron task to schedule YNH backup script
ansible.builtin.cron:
name: "auto-backup to {{ ynh_backup.directory | default('/home/yunohost.backup/archives') }}"
month: "{{ ynh_backup.scheduled_month | default('*') }}"
diff --git a/roles/ynh_config/README-FR.md b/roles/ynh_config/README-FR.md
index 8012a06e873661701f146f2209aad1130d3ce687..99d7fc65a317351895ffd604c0615875bbb4a838 100644
--- a/roles/ynh_config/README-FR.md
+++ b/roles/ynh_config/README-FR.md
@@ -10,14 +10,10 @@ Yunohost doit déjà être installé sur votre serveur.
## Variables du rôle
-------------
-
Les variables par défaut sont disponibles dans `default/main.yml` cependant il est possible de les surcharger selon vos besoins.
### Configuration d'un relais SMTP
-------------
-
```yml
# paramètres personnalisés du relais SMTP
ynh_smtp_relay:
@@ -30,9 +26,7 @@ ynh_smtp_relay:
Yunohost possède son propre serveur SMTP natif mais il est aussi possible de configurer Yunohost pour qu'il utilise un relais SMTP à la place.
Pour faire cela, créez la variable `ynh_smtp_relay` et mettez vos propres valeurs. Vous pouvez en apprendre plus sur les relais SMTP [ici](https://yunohost.org/fr/administrate/specific_use_cases/email_relay).
-### Concernant les mises à jour
-
-------------
+### Configuration des mises à jour
```yml
# Autoupdate Yunohost and its apps
@@ -58,14 +52,10 @@ Pour en savoir plus sur le fonctionnement des mises à jour dans Yunohost vous p
## Dépendances
-------------
-
Aucune.
## Exemple de Playbook
-------------
-
```yml
---
- name: Configure Yunohost on Debian Server
@@ -79,8 +69,6 @@ Aucune.
## License
-------------
-
[](https://choosealicense.com/licenses/gpl-3.0/)
**ansible-yunohost** est maintenu par [Lydra](https://lydra.fr/) et publié sous la licence GPL3.
diff --git a/roles/ynh_config/README.md b/roles/ynh_config/README.md
index 068e81b515bf2369fa9f4ce979e7ff88d89492ce..acf17776dda1d3b35a9170da4f990795d050909c 100644
--- a/roles/ynh_config/README.md
+++ b/roles/ynh_config/README.md
@@ -6,20 +6,14 @@ Deploy [Yunohost](https://yunohost.org/#/) with Ansible!
## Requirements
-------------
-
None.
## Role Variables
-------------
-
Default variables are available in `default/main.yml` however it is necessary to override them according to your needs for Yunohost domains, users and apps.
### SMTP relay configuration
-------------
-
```yml
# SMTP custom settings
ynh_smtp_relay:
@@ -32,9 +26,7 @@ ynh_smtp_relay:
There is a built-in SMTP server on Yunohost but you can also set up Yunohost to use a SMTP relay instead.
In order to do so, create the `ynh_smtp_relay` variable and provide your own values. You can learn more about SMTP relay [here](https://yunohost.org/en/administrate/specific_use_cases/email_relay).
-### About the updates
-
-------------
+### Updates configuration
```yml
# Autoupdate Yunohost and its apps
@@ -60,14 +52,10 @@ To learn more about how updates work in Yunohost you can go [here](https://yunoh
## Dependencies
-------------
-
None.
## Example Playbook
-------------
-
```yml
---
- name: Configure Yunohost on Debian Server
@@ -81,8 +69,6 @@ None.
## License
-------------
-
[](https://choosealicense.com/licenses/gpl-3.0/)
**ansible-yunohost** is maintained by [Lydra](https://lydra.fr/) and released under the GPL3 license.
diff --git a/roles/ynh_setup/README-FR.md b/roles/ynh_setup/README-FR.md
index a3976de5717e45ccdce1fb56d7c1fa64e4545782..7475f5a92e26c1b42c7ac7e66260fc5bb556996d 100644
--- a/roles/ynh_setup/README-FR.md
+++ b/roles/ynh_setup/README-FR.md
@@ -30,10 +30,10 @@ ynh_data_dirs:
ynh_data_dirs.enabled: True
```
-- `ynh_install_script_url` est le script d'installation des packages Yunohost, par défaut c'est le script officiel. Yunohost ne s'installe que sur Debian 10.
+- `ynh_install_script_url` est l'url du script d'installation des packages Yunohost, par défaut c'est le script officiel. Yunohost ne s'installe que sur Debian 10.
- `ynh_admin_password` est le mot de passe permettant d'accéder à l’interface d’administration du serveur.
-- `ynh_data_dirs.enabled`: active les liens symboliques et permet de déplacer les répertoires de configurations et de données de YunoHost où vous le desirez. Mettez la valeur à `True`.
+- `ynh_data_dirs.enabled`: active les liens symboliques et permet de déplacer les répertoires de configurations et de données de YunoHost où vous le desirez. Par défaut, cette valeur est à `True`. Nous utilisons les liens symboliques car le dossier `/data` nous sert à faire des sauvegardes de type _object storage_.
- `ynh_data_dirs.path`: il s'agit des répertoires où stocker les données de configuration de Yunohost ainsi que les applications.
- `ynh_data_dirs.link`: il s'agit des répertoire où seront fait les liens symboliques.
diff --git a/roles/ynh_setup/README.md b/roles/ynh_setup/README.md
index 60edfa21a7c7ee4cbecac4001cc417b52530908e..14b4b051c859e80e127904883adcf0ee8e7c4755 100644
--- a/roles/ynh_setup/README.md
+++ b/roles/ynh_setup/README.md
@@ -30,10 +30,10 @@ ynh_data_dirs:
ynh_data_dirs.enabled: True
```
-- `ynh_install_script_url` downloads official Yunohost script for installing Yunohost packages. Yunohost is only available on Debian 10.
+- `ynh_install_script_url` The url provided downloads the official Yunohost script for installing Yunohost packages. Yunohost is only available on Debian 10.
- `ynh_admin_password` is the password used to access to the server's administration interface.
-- `ynh_data_dirs.enabled`: Enables symbolic links and allows you to move YunoHost's configuration and data directories wherever you want. Set the value to `True`.
+- `ynh_data_dirs.enabled`: Enables symbolic links and allows you to move YunoHost's configuration and data directories wherever you want. By default, this value is set to `True`. We use symbolic links because the `/data` folder is used by us to make _object storage_ backups.
- `ynh_data_dirs.path`: these are the directories where Yunohost configuration data and applications are stored.
- `ynh_data_dirs.link`: this is the directory where symbolic links will be made.