diff --git a/sites/friday/src/get-started/express/_index.md b/sites/friday/src/get-started/express/_index.md
index 6246e0044f..fd132360ac 100644
--- a/sites/friday/src/get-started/express/_index.md
+++ b/sites/friday/src/get-started/express/_index.md
@@ -185,12 +185,12 @@ These YAML configuration files are located into a `.{{% vendor/cli %}}/` folder
 my-express-app
 ├── .{{% vendor/cli %}}
 │   └── config.yaml
-├── .environment
+├── [.environment]
 └── <project sources>
 ```
 
 {{< note >}}
-An additional `.environment` file is located at the root of your source code, this file will override `.env` environment variables with {{% vendor/name %}} specific ones.
+{{% get-started/environment-note %}}
 {{< /note >}}
 
 To pre-generate these YAML files, please use the following command from the root of your Express project and follow the prompts:
diff --git a/sites/friday/src/get-started/express/add-database.md b/sites/friday/src/get-started/express/add-database.md
index 257b330545..7306d21ae0 100644
--- a/sites/friday/src/get-started/express/add-database.md
+++ b/sites/friday/src/get-started/express/add-database.md
@@ -52,7 +52,7 @@ export DB_PASSWORD="$(echo $RELATIONSHIPS_JSON | jq -r '.mariadb[0].password')"
 ```
 
 {{< note >}}
-This additional `.environment` file is located at the root of your source code. During deployment of your {{% vendor/name %}} project, this file will override existing `.env` environment variables with {{% vendor/name %}} specific ones.
+This additional `.environment` file is located at the root of your source code. This file contains {{% vendor/name %}} specific environment variables that will be used during the deployment of your project.
 {{< /note >}}
 
 Commit your change:
diff --git a/sites/friday/src/get-started/nextjs/_index.md b/sites/friday/src/get-started/nextjs/_index.md
index e4fc0d8144..bfe6cfeefe 100644
--- a/sites/friday/src/get-started/nextjs/_index.md
+++ b/sites/friday/src/get-started/nextjs/_index.md
@@ -171,12 +171,12 @@ These YAML configuration files are located into a `.{{% vendor/cli %}}/` folder
 my-nextjs-app
 ├── .{{% vendor/cli %}}
 │   └── config.yaml
-├── .environment
+├── [.environment]
 └── <project sources>
 ```
 
 {{< note >}}
-An additional `.environment` file is located at the root of your source code, this file will override `.env` environment variables with {{% vendor/name %}} specific ones.
+{{% get-started/environment-note %}}
 {{< /note >}}
 
 To pre-generate these YAML files, please use the following command from the root of your Next.js project and follow the prompts:
diff --git a/sites/friday/src/get-started/strapi/_index.md b/sites/friday/src/get-started/strapi/_index.md
index a6e549ac0d..9ed8a40251 100644
--- a/sites/friday/src/get-started/strapi/_index.md
+++ b/sites/friday/src/get-started/strapi/_index.md
@@ -162,12 +162,12 @@ These YAML configuration files are located inside a `.{{% vendor/cli %}}/` folde
 my-strapi-project
 ├── .{{% vendor/cli %}}
 │   └── config.yaml
-├── .environment
+├── [.environment]
 └── <project sources>
 ```
 
 {{< note >}}
-An additional `.environment` file is located at the root of your source code, this file will override `.env` environment variables with {{% vendor/name %}} specific ones.
+{{% get-started/environment-note %}}
 {{< /note >}}
 
 To pre-generate these YAML files, please use the following command from the root of your Strapi application and follow the prompts:
diff --git a/themes/psh-docs/layouts/shortcodes/get-started/environment-note.md b/themes/psh-docs/layouts/shortcodes/get-started/environment-note.md
new file mode 100644
index 0000000000..cea7149dbe
--- /dev/null
+++ b/themes/psh-docs/layouts/shortcodes/get-started/environment-note.md
@@ -0,0 +1 @@
+An additional `.environment` file could be located at the root of your source code, this file would contain {{ .Site.Params.vendor.name }} specific environment variables.