diff --git a/docs/customization.md b/docs/customization.md
index 94587efcb0c2c7155225900148f7cb6fe56a3226..54804f8fe3920047d7e71b48978e30ffff081aae 100644
--- a/docs/customization.md
+++ b/docs/customization.md
@@ -69,6 +69,10 @@ For example, to change the link color from the purple default to blue, include t
 $link-color: $blue-000;
 ```
 
+Keep in mind that changing a variable will not automatically change the value of other variables that depend on it.
+For example, the default link color (`$link-color`) is set to `$purple-000`. However, redefining `$purple-000` in a custom color scheme will not automatically change `$link-color` to match it.
+Instead, each variable that relies on previously-cascaded values must be manually reimplemented by copying the dependent rules from `_variables.scss` — in this case, rewriting `$link-color: $purple-000;`.
+
 _Note:_ Editing the variables directly in `_sass/support/variables.scss` is not recommended and can cause other dependencies to fail.
 Please use scheme files.