json-api
diff --git a/‎extensions/jsonpatch/index.md
Lines changed: 13 additions & 14 deletions b/‎extensions/jsonpatch/index.md
Lines changed: 13 additions & 14 deletions
@@ -27,7 +27,7 @@ operations allowed in this top level array.
 ### Request URLs and Patch Paths <a href="#patch-urls" id="patch-urls" class="headerlink"></a>
 
 The request URL and each Patch operation's `"path"` are complementary and
-**MUST** combine to target a particular resource, collection, attribute, or
+**MUST** combine to target a particular resource, collection, resource attribute, or
 relationship.
 
 If a server supports the Patch extension, it **MUST** allow Patch operations at
@@ -65,9 +65,9 @@ Accept: application/vnd.api+json; ext=jsonpatch
 ]
 ```
 
-### Updating Attributes <a href="#patch-updating-attributes" id="patch-updating-attributes" class="headerlink"></a>
+### Updating Resource Attributes <a href="#patch-updating-attributes" id="patch-updating-attributes" class="headerlink"></a>
 
-To update an attribute, perform a `"replace"` operation with the attribute's
+To update a resource attribute, perform a `"replace"` operation with the attribute's
 name specified by the `"path"`.
 
 For instance, the following request should update just the `src` property of the
@@ -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"` should be a linkage object.
 
 For instance, the following request should update the `author` of an article:
 
@@ -129,9 +128,8 @@ Accept: application/vnd.api+json; ext=jsonpatch
 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.
+For all operations, the `"value"` **MUST** be a linkage object,
+or an array of linkage objects.
 
 If a client requests a `"replace"` operation to a *to-many relationship URL*, the
 server **MUST** either completely replace every member of the relationship,
@@ -162,11 +160,12 @@ To add an element to a to-many relationship, request an `"add"` operation that
 targets the relationship's URL. Because the operation is targeting the end of a
 collection, the `"path"` must end with `"/-"`.
 
-In the following example, the comment with ID `123` is added to the list of
-comments for the article with ID `1`:
+In the following example, the new reprint with ID `123` is added to the list of
++publications of the article with ID `1` ():
+
 
 ```text
-PATCH /articles/1/links/comments
+PATCH /articles/1/links/publications
 Content-Type: application/vnd.api+json; ext=jsonpatch
 Accept: application/vnd.api+json; ext=jsonpatch
 
@@ -175,7 +174,7 @@ Accept: application/vnd.api+json; ext=jsonpatch
     "op": "add", 
     "path": "/-", 
     "value": [
-      { "type": "comments", "id": "123" }
+      { "type": "magazines", "id": "123", "publication_type": "reprint" }
     ]
   }
 ]
@@ -226,8 +225,8 @@ Accept: application/vnd.api+json; ext=jsonpatch
 #### 204 No Content <a href="#patch-responses-204" id="patch-responses-204" class="headerlink"></a>
 
 A server **MUST** return a `204 No Content` status code in response to a
-successful Patch operation in which the client's current attributes remain up to
-date.
+successful Patch operation in which the client's current resource attributes 
+remain up to date.
 
 #### 200 OK <a href="#patch-responses-200" id="patch-responses-200" class="headerlink"></a>