diff --git a/config/environments/development.js.example b/config/environments/development.js.example
index e249c479..e28c51e6 100644
--- a/config/environments/development.js.example
+++ b/config/environments/development.js.example
@@ -149,9 +149,9 @@ var config = {
     }
     ,varnish: {
         host: 'localhost',
-        port: 6082,
-        http_port: 6081,
-        purge_enabled: false,
+        port: 6082, // the por for the telnet interface where varnish is listening to
+        http_port: 6081, // the port for the HTTP interface where varnish is listening to
+        purge_enabled: false, // whether the purge/invalidation mechanism is enabled in varnish or not
         secret: 'xxx',
         ttl: 86400,
         layergroupTtl: 86400 // the max-age for cache-control header in layergroup responses
diff --git a/config/environments/production.js.example b/config/environments/production.js.example
index 2b03478a..6c4ea756 100644
--- a/config/environments/production.js.example
+++ b/config/environments/production.js.example
@@ -143,9 +143,9 @@ var config = {
     }
     ,varnish: {
         host: 'localhost',
-        port: 6082,
-        http_port: 6081,
-        purge_enabled: false,
+        port: 6082, // the por for the telnet interface where varnish is listening to
+        http_port: 6081, // the port for the HTTP interface where varnish is listening to
+        purge_enabled: false, // whether the purge/invalidation mechanism is enabled in varnish or not
         secret: 'xxx',
         ttl: 86400,
         layergroupTtl: 86400 // the max-age for cache-control header in layergroup responses
diff --git a/config/environments/staging.js.example b/config/environments/staging.js.example
index 2403f26d..f8da00db 100644
--- a/config/environments/staging.js.example
+++ b/config/environments/staging.js.example
@@ -143,9 +143,9 @@ var config = {
     }
     ,varnish: {
         host: 'localhost',
-        port: 6082,
-        http_port: 6081,
-        purge_enabled: false,
+        port: 6082, // the por for the telnet interface where varnish is listening to
+        http_port: 6081, // the port for the HTTP interface where varnish is listening to
+        purge_enabled: false, // whether the purge/invalidation mechanism is enabled in varnish or not
         secret: 'xxx',
         ttl: 86400,
         layergroupTtl: 86400 // the max-age for cache-control header in layergroup responses
diff --git a/config/environments/test.js.example b/config/environments/test.js.example
index 1c662c63..5866e6c5 100644
--- a/config/environments/test.js.example
+++ b/config/environments/test.js.example
@@ -145,9 +145,9 @@ var config = {
     }
     ,varnish: {
         host: '',
-        port: null,
-        http_port: 6081,
-        purge_enabled: false,
+        port: null, // the por for the telnet interface where varnish is listening to
+        http_port: 6081, // the port for the HTTP interface where varnish is listening to
+        purge_enabled: false, // whether the purge/invalidation mechanism is enabled in varnish or not
         secret: 'xxx',
         ttl: 86400,
         layergroupTtl: 86400 // the max-age for cache-control header in layergroup responses