{"action":"opened","issue":{"url":"https://api.github.com/repos/graphql/graphql-js/issues/176","labels_url":"https://api.github.com/repos/graphql/graphql-js/issues/176/labels{/name}","comments_url":"https://api.github.com/repos/graphql/graphql-js/issues/176/comments","events_url":"https://api.github.com/repos/graphql/graphql-js/issues/176/events","html_url":"https://github.com/graphql/graphql-js/issues/176","id":106407423,"number":176,"title":"Improve documentation coverage and detail","user":{"login":"Aweary","id":6886061,"avatar_url":"https://avatars.githubusercontent.com/u/6886061?v=3","gravatar_id":"","url":"https://api.github.com/users/Aweary","html_url":"https://github.com/Aweary","followers_url":"https://api.github.com/users/Aweary/followers","following_url":"https://api.github.com/users/Aweary/following{/other_user}","gists_url":"https://api.github.com/users/Aweary/gists{/gist_id}","starred_url":"https://api.github.com/users/Aweary/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Aweary/subscriptions","organizations_url":"https://api.github.com/users/Aweary/orgs","repos_url":"https://api.github.com/users/Aweary/repos","events_url":"https://api.github.com/users/Aweary/events{/privacy}","received_events_url":"https://api.github.com/users/Aweary/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-09-14T19:03:36Z","updated_at":"2015-09-14T19:03:36Z","closed_at":null,"body":"The README is a _decent_ overview but I feel like this Technical Preview may benefit from a better defined API reference or documentation. \r\n\r\nNow I know this is a Technical Preview, which some may argue means that documentation isn't as important, which others may argue that documentation is _especially_ beneficial. Even if the API does change, it seems at least somewhat beneficial to document it as best we can as it goes along.\r\n\r\nWhat do you guys think? Is it worth the effort in your eyes?\r\n\r\n"}}