diff --git a/environments/README.md b/environments/README.md
index 873e9c4..371a555 100644
--- a/environments/README.md
+++ b/environments/README.md
@@ -1,6 +1,9 @@
-# Intro
+# Environments folder
+The environments folder contains the .env files for the applications.
 
-The environments folder contains the env files for application it can be shared among workflows and it's intended to keep multiple environments under folder names for instance, montreal city layers env will be placed in montreal_citylayers (%BASE_PATH%/environments/__montreal_citylayers/.env)
+The files can be shared among workflows and it's intended to keep multiple environments under folder names for instance, this allows to for instance to have a retrofit env for montreal and anotherone for nyc.
+
+In this example, montreal city layers env will be placed in **montreal_citylayers** *(%BASE_PATH%/environments/**montreal_citylayers**/.env)* while nyc city layers will be stored in **nyc_citylayers** *(%BASE_PATH%/environments/**nyc_citylayers**/.env)*
 
 # env files structure