Update examples to use single objects instead of arrays #239
Conversation
| @@ -380,13 +380,13 @@ Here's another example: | |||
| "links": { | |||
| "posts.comments": "http://example.com/comments/{posts.comments}" | |||
| }, | |||
| "posts": [{ | |||
There was a problem hiding this comment.
I'm not sure this instance should be changed. My understanding of the spec is that a single resource such as /posts/1 could be represented as a single object, where as a collection of resources /posts should be represented as a collection, even if there is only one item in the collection. That said, I could be misreading the spec - it doesn't seem to clarify whether a "singular resource" is when a single resource is returned, or when a single resource is requested.
There was a problem hiding this comment.
@BRMatt you are definitely right here
What got me confused is that on the front page it's not obvious what is being fetched, a resource or a collection
|
@BRMatt @whatthewhat I just created #240 which attempts to clarify the singular / plural issue with different wording. Please let me know if this change works for you. |
This replaces arrays with a single object as defined in #237
I'm not sure, but on the front page it might look better to leave the array and add a second post..