From fe128d797e8fb770181f1068d8e762e99d6f3057 Mon Sep 17 00:00:00 2001
From: Dale Wijnand <344610+dwijnand@users.noreply.github.com>
Date: Sat, 21 Jul 2018 06:41:48 +0100
Subject: [PATCH] Tweak the global RHS part of the best practices

---
 .../03-Plugins-Best-Practices.md                             | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/reference/02-DetailTopics/05-Plugins-and-Best-Practices/03-Plugins-Best-Practices.md b/src/reference/02-DetailTopics/05-Plugins-and-Best-Practices/03-Plugins-Best-Practices.md
index aa7d78139..6e29e0ad6 100644
--- a/src/reference/02-DetailTopics/05-Plugins-and-Best-Practices/03-Plugins-Best-Practices.md
+++ b/src/reference/02-DetailTopics/05-Plugins-and-Best-Practices/03-Plugins-Best-Practices.md
@@ -353,8 +353,9 @@ or scoped to `ThisBuild` affecting all subprojects:
 ThisBuild / obfuscate / obfuscateOption := ObfuscateOption().withX(true)
 ```
 
-This requires in-depth knowledge to know that RHS are all contained in
-global scope (pure values and other global settings), but it's a useful technique.
+Giving keys default values in global scope requires knowing that every key (if any)
+used to define that key must _also_ be defined in global scope, otherwise it will
+fail at load time.
 
 #### Using a "main" task scope for settings