From 0cbd82491f985a34071471ea4594faf4a6fd0638 Mon Sep 17 00:00:00 2001
From: Quentin Duchemin <quentinduchemin@tuta.io>
Date: Thu, 28 May 2020 22:00:56 +0200
Subject: [PATCH] [Doc] Remove shitty advice about external volumes

---
 doc/guide_bonnes_pratiques.md | 8 ++++++--
 pica-etherpad/README.md       | 1 +
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/doc/guide_bonnes_pratiques.md b/doc/guide_bonnes_pratiques.md
index 4093d3ac..c9b46ff1 100644
--- a/doc/guide_bonnes_pratiques.md
+++ b/doc/guide_bonnes_pratiques.md
@@ -76,8 +76,8 @@ Exemple à reprendre :
 volumes:
   # Nom du volume Docker
   db:
-    # On préfère gérer les volumes nous-même
-    external: true
+    # On force le nom utilisé par Docker
+    name: db
 
   services:
     exemple:
@@ -86,6 +86,10 @@ volumes:
         - db:/mount_point
 ```
 
+Il est suggéré d'éviter les volumes déclarés `external` :
+* Un volume créé en dehors de Docker Compose peut être utilisé sans être déclaré `external` ;
+* En revanche un volume non-créé et déclaré `external` fera échouer Docker Compose.
+
 ## Reverse-proxy
 
 Si le service est un service **HTTP(S)** (*i.e.* Web), on utilisera systématiquement le reverse-proxy [Traefik](https://wiki.picasoft.net/doku.php?id=technique:infrastructure:archi#traefik) et on bindera **pas** son port interne sur un port de l'hôte.
diff --git a/pica-etherpad/README.md b/pica-etherpad/README.md
index e8a3932b..54499f38 100644
--- a/pica-etherpad/README.md
+++ b/pica-etherpad/README.md
@@ -55,6 +55,7 @@ docker-compose up -d etherpad-app && docker-compose logs -f
 docker-compose up -d etherpad-week-app && docker-compose logs -f
 ```
 
+Attention, les fichiers de secrets doivent tous exister, même ceux non-utilisés.
 ## Ajout d'un plugin
 
 Etherpad maintient une [liste officielle des plugins](https://static.etherpad.org/plugins.html).
-- 
GitLab