{"action":"created","issue":{"url":"https://api.github.com/repos/rails-api/active_model_serializers/issues/1301","labels_url":"https://api.github.com/repos/rails-api/active_model_serializers/issues/1301/labels{/name}","comments_url":"https://api.github.com/repos/rails-api/active_model_serializers/issues/1301/comments","events_url":"https://api.github.com/repos/rails-api/active_model_serializers/issues/1301/events","html_url":"https://github.com/rails-api/active_model_serializers/pull/1301","id":113292501,"number":1301,"title":"Mapping JSON API spec / schema to AMS [ci skip]","user":{"login":"bf4","id":142914,"avatar_url":"https://avatars.githubusercontent.com/u/142914?v=3","gravatar_id":"","url":"https://api.github.com/users/bf4","html_url":"https://github.com/bf4","followers_url":"https://api.github.com/users/bf4/followers","following_url":"https://api.github.com/users/bf4/following{/other_user}","gists_url":"https://api.github.com/users/bf4/gists{/gist_id}","starred_url":"https://api.github.com/users/bf4/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bf4/subscriptions","organizations_url":"https://api.github.com/users/bf4/orgs","repos_url":"https://api.github.com/users/bf4/repos","events_url":"https://api.github.com/users/bf4/events{/privacy}","received_events_url":"https://api.github.com/users/bf4/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/rails-api/active_model_serializers/labels/C:%20JSON%20API","name":"C: JSON API","color":"CCCCCC"},{"url":"https://api.github.com/repos/rails-api/active_model_serializers/labels/Changelog%20Missing","name":"Changelog Missing","color":"fbca04"},{"url":"https://api.github.com/repos/rails-api/active_model_serializers/labels/Documentation","name":"Documentation","color":"fbca04"},{"url":"https://api.github.com/repos/rails-api/active_model_serializers/labels/Needs%20Team%20Discussion","name":"Needs Team Discussion","color":"5319e7"},{"url":"https://api.github.com/repos/rails-api/active_model_serializers/labels/RFC","name":"RFC","color":"fbca04"},{"url":"https://api.github.com/repos/rails-api/active_model_serializers/labels/V:%200.10.x","name":"V: 0.10.x","color":"bfd4f2"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-10-26T06:16:26Z","updated_at":"2015-10-26T11:36:32Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/rails-api/active_model_serializers/pulls/1301","html_url":"https://github.com/rails-api/active_model_serializers/pull/1301","diff_url":"https://github.com/rails-api/active_model_serializers/pull/1301.diff","patch_url":"https://github.com/rails-api/active_model_serializers/pull/1301.patch"},"body":"This is something to think about. I'm not 100% sure if it should be\r\nin the docs or in an issue, than a PR. But, I think it might be useful for discussion\r\nAs we work on [JSON API](https://github.com/rails-api/active_model_serializers/issues/1235).\r\n\r\n[View formatted](https://github.com/rails-api/active_model_serializers/blob/jsonapi_schema/docs/jsonapi/schema.md)\r\n\r\n1. Trying to surface which parts of the code map to the JSON API spec\r\n2. Use point 1 to consider design and naming of objects\r\n3. Track completeness of implementation\r\n4. TODO: Use schema/schema.json to validate and document our implementation\r\n  - https://github.com/rails-api/active_model_serializers/pull/1270\r\n  - https://github.com/rails-api/active_model_serializers/issues/1162\r\n  - maybe use prmd? http://www.sitepoint.com/document-your-json-api-schema-with-prmd/\r\n5. TODO: use uri_template in link generation? use json pointer gem? \r\n  - https://github.com/rails-api/active_model_serializers/pull/1282#discussion_r42528812\r\n  - > I believe what you want here is a uri_template. See https://github.com/hannesg/uri_template See e.g. https://developer.github.com/v3/#schema http://tools.ietf.org/html/rfc6570 see e.g. https://api.github.com/ (though not a JSON API, is an example of usage)\r\n\r\nThere are for sure formatting and possible correctness issues. I mean it as a point of discussion."},"comment":{"url":"https://api.github.com/repos/rails-api/active_model_serializers/issues/comments/151106898","html_url":"https://github.com/rails-api/active_model_serializers/pull/1301#issuecomment-151106898","issue_url":"https://api.github.com/repos/rails-api/active_model_serializers/issues/1301","id":151106898,"user":{"login":"NullVoxPopuli","id":199018,"avatar_url":"https://avatars.githubusercontent.com/u/199018?v=3","gravatar_id":"","url":"https://api.github.com/users/NullVoxPopuli","html_url":"https://github.com/NullVoxPopuli","followers_url":"https://api.github.com/users/NullVoxPopuli/followers","following_url":"https://api.github.com/users/NullVoxPopuli/following{/other_user}","gists_url":"https://api.github.com/users/NullVoxPopuli/gists{/gist_id}","starred_url":"https://api.github.com/users/NullVoxPopuli/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/NullVoxPopuli/subscriptions","organizations_url":"https://api.github.com/users/NullVoxPopuli/orgs","repos_url":"https://api.github.com/users/NullVoxPopuli/repos","events_url":"https://api.github.com/users/NullVoxPopuli/events{/privacy}","received_events_url":"https://api.github.com/users/NullVoxPopuli/received_events","type":"User","site_admin":false},"created_at":"2015-10-26T11:36:32Z","updated_at":"2015-10-26T11:36:32Z","body":"this is fantastic. This will be great for people just getting in to JSON API (re: me, ;-) )"}}