Merge pull request #68 from lornajane/better-merge-words

Update wording for how updates work

Author: mikekistler

versions/1.0.0.md

@@ -107,7 +107,7 @@ To update a primitive property value such as a string, the `target` expression s
 
 Primitive-valued items of an array cannot be replaced or removed individually, only the complete array can be replaced.
 
-The properties of the `update` object MUST be compatible with the target object referenced by the JSONPath key. When the Overlay document is applied, the properties in the `update` object replace properties in the target object with the same name and new properties are appended to the target object.
+The properties of the `update` object MUST be compatible with the target object referenced by the JSONPath key. When the Overlay document is applied, the properties in the `update` object are recursively merged with the properties in the target object with the same names; new properties are added to the target object.
 
 This object MAY be extended with [Specification Extensions](#specification-extensions).