json-api · hhware · Apr 6, 2015 · Apr 6, 2015 · Apr 7, 2015
diff --git a/extensions/jsonpatch/index.md b/extensions/jsonpatch/index.md
@@ -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
@@ -162,11 +162,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 +176,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 +227,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>