Add describedby example link

json-api · dgeb · Jan 8, 2020 · Nov 5, 2019 · Dec 3, 2019 · Dec 11, 2019
commit 0e1e17d185b788c09fcd3310b2cc824364f9c734
diff --git a/_format/1.1/index.md b/_format/1.1/index.md
@@ -556,13 +556,15 @@ key in an [error object]'s links object, each key present in a links object
 
 In the example below, the `self` link is simply a URI string, whereas the
 `related` link uses the object form to provide meta information about a
-related resource collection:
+related resource collection as well as a schema that serves as a description
+document for that collection:
 
 ```json
 "links": {
-  "self": "http://example.com/articles/1",
+  "self": "http://example.com/articles/1/relationships/comments",
   "related": {
     "href": "http://example.com/articles/1/comments",
+    "describedby": "http://example.com/schemas/article-comments",
     "meta": {
       "count": 10
     }