From b2c731b4719ff6380a56d71760a7aafed2deef23 Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Tue, 10 Mar 2026 00:44:30 +0300
Subject: [PATCH 1/2] Add comments to .env about applicability of the
 environment variables

---
 docker/.env      | 2 ++
 docker/dev/.env  | 3 +++
 docker/prod/.env | 3 +++
 docker/test/.env | 3 +++
 4 files changed, 11 insertions(+)

diff --git a/docker/.env b/docker/.env
index e704cbd2..6207b1ac 100644
--- a/docker/.env
+++ b/docker/.env
@@ -1,3 +1,5 @@
+# Variables are available in both app and compose.yml.
+
 STACK_NAME=app
 
 # Development
diff --git a/docker/dev/.env b/docker/dev/.env
index 8e5aaf70..6cb1d7dc 100644
--- a/docker/dev/.env
+++ b/docker/dev/.env
@@ -1,3 +1,6 @@
+# App dev environment.
+# Note that variables are available in the app only, not in compose.yml.
+
 APP_ENV=dev
 APP_DEBUG=true
 SERVER_NAME=:80
diff --git a/docker/prod/.env b/docker/prod/.env
index 78648a87..d5ca79d4 100644
--- a/docker/prod/.env
+++ b/docker/prod/.env
@@ -1,3 +1,6 @@
+# App prod environment.
+# Note that variables are available in the app only, not in compose.yml.
+
 APP_ENV=prod
 APP_DEBUG=false
 SERVER_NAME=:80
diff --git a/docker/test/.env b/docker/test/.env
index 7e1dd8ae..3dcbdaac 100644
--- a/docker/test/.env
+++ b/docker/test/.env
@@ -1,3 +1,6 @@
+# App test environment.
+# Note that variables are available in the app only, not in compose.yml.
+
 APP_ENV=test
 APP_DEBUG=false
 APP_C3=true

From cef41caeef54b2a850ea18cc34be54d7d9daaa0f Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Tue, 10 Mar 2026 01:16:04 +0300
Subject: [PATCH 2/2] Update info about root .env

---
 docker/.env | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker/.env b/docker/.env
index 6207b1ac..d89c1080 100644
--- a/docker/.env
+++ b/docker/.env
@@ -1,4 +1,4 @@
-# Variables are available in both app and compose.yml.
+# Variables for compose.yml files. Not available in the app.
 
 STACK_NAME=app