diff --git a/docker-compose.override.yml b/docker-compose.override.yml
index c322d58f1e30cb367de8cb5e69c139393252b0e0..906b3801f0d72ddc2a6eae97c4f40b29504cb8be 100644
--- a/docker-compose.override.yml
+++ b/docker-compose.override.yml
@@ -1,3 +1,4 @@
+# Define open ports on the service
 version: '3.1'
 services:
   webserver:
diff --git a/docker-compose.proxy.yml b/docker-compose.proxy.yml
index 351f59760dcc1f22d00f1d7fd04d10ef6a845f13..e336775479e9d2704ee8afb712a2db670802d8a4 100644
--- a/docker-compose.proxy.yml
+++ b/docker-compose.proxy.yml
@@ -39,12 +39,14 @@ services:
     - ./deploy/proxy.conf:/etc/nginx/proxy.conf
     networks:
     - proxy
-    
+
 networks:
   proxy:
     name: proxy
+    external: true
+    # Comment the rest of the definition if the network is already defined outside of the compose file
+    # for example by running docker network create command
     attachable: true
     driver: overlay
     driver_opts:
-      encrypted: 1
-    external: true
\ No newline at end of file
+      encrypted: 1
\ No newline at end of file
diff --git a/docker-compose.swarm.yml b/docker-compose.swarm.yml
index b75e6306165bbfed06c7829831c133aded4703e2..3825bb065e8e05d3e10b6838f52c848cfd2b07a5 100644
--- a/docker-compose.swarm.yml
+++ b/docker-compose.swarm.yml
@@ -1,3 +1,4 @@
+# This is the docker swarm version writtent to run with nginxproxy
 version: '3.7'
 services:
   webserver:
diff --git a/docker-compose.yml b/docker-compose.yml
index f4141c13bb027adaffd2af3688cedceec984748f..3ae1f93b0399e7c045a0cd09d17469e380123ab7 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,3 +1,4 @@
+# Basic compose file mainly used to build the container image
 version: '3.1'
 services:
   webserver: