diff --git a/docs/_docs/configuration/environments.md b/docs/_docs/configuration/environments.md
index 8ce0e418..be8d376f 100644
--- a/docs/_docs/configuration/environments.md
+++ b/docs/_docs/configuration/environments.md
@@ -41,3 +41,9 @@ environment but not include it in production environments.
 
 By specifying the option in the build command, you avoid having to change
 values in your configuration files when moving from one environment to another.
+
+<div class="note info">
+  <p>
+    To switch part of your config settings depending on the environment, use the <a href="/docs/configuration/options/#build-command-options">build command option</a>, for example <code>--config _config.yml,_config_development.yml</code>. Settings in later files override settings in earlier files.
+  </p>
+</div>