Better multiple related resources request example (json-api#1227)

bf4 · dgeb · jelhan · web-flow · commit adc530bf07a2 · 2022-06-10T16:32:59.000-04:00
* Better multiple related resources request example

&gt; GET /articles/1?include=author,comments.author

is confusing since `author` and `comments.author` both reference the `author` resource', 
but with different meaning.

It looks a lot like

GET /users/1?include=articles,articles.comments

which is identical to

GET /users/1?include=articles.comments

since full linkage requires intermediate resources to be returned

So, I've changed the the related resources to be more obviously different

* Update _format/1.0/index.md

Co-authored-by: Jeldrik Hanschke &lt;jelhan@users.noreply.github.com&gt;

Co-authored-by: Dan Gebhardt &lt;dan@cerebris.com&gt;
Co-authored-by: Jeldrik Hanschke &lt;jelhan@users.noreply.github.com&gt;
diff --git a/_format/1.0/index.md b/_format/1.0/index.md
@@ -973,7 +973,7 @@ resources.
 Multiple related resources can be requested in a comma-separated list:
 
 ```http
-GET /articles/1?include=author,comments.author HTTP/1.1
+GET /articles/1?include=comments.author,ratings HTTP/1.1
 Accept: application/vnd.api+json
 ```
 
