json-api/json-api — pull request #99 by gabrielgrant (2013-05-27 15:43:29+00:00)
Title: change link removal example to be "set-like" rather than "array-like"

The example of "removing comment 5 from this photo" uses "/photos/0/links/comments/1" as it's path. That references the array index of the comment in it's collection, treating it like an array, however the surrounding text explicitly states that "to-many relationships have set-like behavior in JSON API"

This set-like behavior isn't really defined (it isn't mentioned anywhere in [the JSON Patch RFC](http://tools.ietf.org/html/rfc6902) ), but it seems like it should mean "values are returned as an array, but the items in that array should be treated as though they were object keys with ignorable values". Basically, the order of that array should be explicitly ignored, and references should be by ID rather that array index.

This would to imply that the example should be "/photos/0/links/comments/*5*" (by ID -- it's a set, not by array index)