{"action":"created","issue":{"url":"https://api.github.com/repos/facebook/graphql/issues/90","labels_url":"https://api.github.com/repos/facebook/graphql/issues/90/labels{/name}","comments_url":"https://api.github.com/repos/facebook/graphql/issues/90/comments","events_url":"https://api.github.com/repos/facebook/graphql/issues/90/events","html_url":"https://github.com/facebook/graphql/pull/90","id":104389416,"number":90,"title":"[RFC] GraphQL IDL additions","user":{"login":"leebyron","id":50130,"avatar_url":"https://avatars.githubusercontent.com/u/50130?v=3","gravatar_id":"","url":"https://api.github.com/users/leebyron","html_url":"https://github.com/leebyron","followers_url":"https://api.github.com/users/leebyron/followers","following_url":"https://api.github.com/users/leebyron/following{/other_user}","gists_url":"https://api.github.com/users/leebyron/gists{/gist_id}","starred_url":"https://api.github.com/users/leebyron/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/leebyron/subscriptions","organizations_url":"https://api.github.com/users/leebyron/orgs","repos_url":"https://api.github.com/users/leebyron/repos","events_url":"https://api.github.com/users/leebyron/events{/privacy}","received_events_url":"https://api.github.com/users/leebyron/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/facebook/graphql/labels/CLA%20Signed","name":"CLA Signed","color":"009900"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":6,"created_at":"2015-09-02T02:13:17Z","updated_at":"2016-01-23T23:53:17Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/facebook/graphql/pulls/90","html_url":"https://github.com/facebook/graphql/pull/90","diff_url":"https://github.com/facebook/graphql/pull/90.diff","patch_url":"https://github.com/facebook/graphql/pull/90.patch"},"body":"This adds the type definition syntax to the GraphQL specification.\r\n\r\nThere are some remaining issues to solve:\r\n\r\n* [ ] Include reference in Execution chapter about non-executable GraphQL\r\n* [ ] Description is not yet represented\r\n* [ ] Deprecation is not yet represented\r\n* [ ] Top level Schema is not yet represented\r\n* [ ] Investigate impact on validation rules"},"comment":{"url":"https://api.github.com/repos/facebook/graphql/issues/comments/174235309","html_url":"https://github.com/facebook/graphql/pull/90#issuecomment-174235309","issue_url":"https://api.github.com/repos/facebook/graphql/issues/90","id":174235309,"user":{"login":"joshprice","id":9307,"avatar_url":"https://avatars.githubusercontent.com/u/9307?v=3","gravatar_id":"","url":"https://api.github.com/users/joshprice","html_url":"https://github.com/joshprice","followers_url":"https://api.github.com/users/joshprice/followers","following_url":"https://api.github.com/users/joshprice/following{/other_user}","gists_url":"https://api.github.com/users/joshprice/gists{/gist_id}","starred_url":"https://api.github.com/users/joshprice/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/joshprice/subscriptions","organizations_url":"https://api.github.com/users/joshprice/orgs","repos_url":"https://api.github.com/users/joshprice/repos","events_url":"https://api.github.com/users/joshprice/events{/privacy}","received_events_url":"https://api.github.com/users/joshprice/received_events","type":"User","site_admin":false},"created_at":"2016-01-23T23:53:17Z","updated_at":"2016-01-23T23:53:17Z","body":"For reference there are some concrete examples here: https://github.com/matthewmueller/graph.ql\r\n\r\nDescriptions are assumed to be in comments immediately preceding the thing it's describing, assuming deprecation etc could be handled in a similar fashion with a specially formatted comment.\r\n\r\nAnother possibility for metadata might be type annotations starting with `@`:\r\n\r\n```graphql\r\n@description Describes a person\r\ntype Person {\r\n  @isDeprecated true\r\n  field: Int\r\n}\r\n```"}}