Clarify-relationship-formatting-jsonpatch

hhware · hhware · commit 3628378078db · 2015-03-28T16:04:03.000-05:00
diff --git a/extensions/jsonpatch/index.md b/extensions/jsonpatch/index.md
@@ -96,8 +96,7 @@ target a particular relationship's URL.
 #### Updating To-One Relationships <a href="#patch-updating-to-one-relationships" id="patch-updating-to-one-relationships" class="headerlink"></a>
 
 To update a to-one relationship, perform a `"replace"` operation with a URL and
-`"path"` that targets the relationship. The `"value"` should be a link object
-that contains `"type"` and `"id"` members.
+`"path"` that targets the relationship. The `"value"` **MUST** be a linkage object.
 
 For instance, the following request should update the `author` of an article:
 
@@ -130,8 +129,8 @@ A server **MUST** respond to Patch operations that target a *to-many
 relationship URL* as described below.
 
 For all operations, the `"value"` **MUST** contain an object that contains
-`type` and `id` members, or an array of objects that each contain `type`
-and `id` members.
+an empty array or an array of linkage objects.
+An empty array will remove all elements of the relationship.
 
 If a client requests a `"replace"` operation to a *to-many relationship URL*, the
 server **MUST** either completely replace every member of the relationship,
