diff --git a/docs/configuration.md b/docs/configuration.md
index 33d0ecf14ab..eb662cbbedc 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -35,10 +35,15 @@ Your local configuration of Poetry application is stored in the `poetry.toml` fi
 which is separate from `pyproject.toml`.
 {{% /note %}}
 
-{{% warning %}}
-Be mindful about checking in this file into your repository since it may contain user-specific or sensitive information.
+{{% note %}}
+If a setting is defined in both `poetry.toml` (local/project) and `config.toml` (global),
+the local/project configuration takes precedence over the global configuration.
 {{% /note %}}
 
+{{% warning %}}
+Be mindful when checking in this file into your repository since it may contain user-specific or sensitive information.
+{{% /warning %}}
+
 ## Listing the current configuration
 
 To list the current configuration you can use the `--list` option