diff --git a/README b/README
index 5aa0aca..a1ae805 100644
--- a/README
+++ b/README
@@ -234,8 +234,10 @@
 parameters.
 
 Merging of parameters is done recursively, meaning that lists and dictionaries
-are extended, rather than replaced. There is currently no way to remove or
-overwrite an existing value.
+are extended (recursively), rather than replaced. However, a scalar value
+*does* overwrite a dictionary or list value. While the scalar could be
+appended to an existing list, there is sane default assumption in the context
+of a dictionary, so this behaviour seems the most logical.
 
 Finally, parameters may reference each other, including deep references, e.g.:
 
diff --git a/README.Salt b/README.Salt
index 4fe8e0f..42b4ce7 100644
--- a/README.Salt
+++ b/README.Salt
@@ -133,8 +133,8 @@
 the pillar data of a specific node.
 
 However, the pillar data of a node include all the information about classes
-and applications, so you can use them to target your Salt calls at groups of
-nodes defined in the reclass inventory, e.g.
+and applications, so you could theoretically use them to target your Salt
+calls at groups of nodes defined in the reclass inventory, e.g.
 
   salt -I __reclass__:classes:salt_minion test.ping