diff --git a/README.md b/README.md
index 644f320..75c0743 100644
--- a/README.md
+++ b/README.md
@@ -64,8 +64,9 @@ docker run -p 3000:3000 astral:latest
 
 # Configuration
 Astral is configured in `config/astral.yml` -- all availble
-configuration options are all listed there. Note that configuration
-values can be supplied in this file or as environment variables with
-the same names (but UPPER_CASE). Environment vars will override any
-values here. Per-environment settings (development, test, production)
-will override the shared values.
+configuration options are listed there in the `shared` section. Note
+that configuration values can be supplied in this file or as
+environment variables with the same names (but
+UPPER_CASE). Environment vars will override any values
+here. Per-environment settings (development, test, production) will
+override the shared values but not the environment.