{"action":"created","issue":{"url":"https://api.github.com/repos/graphql/graphql-relay-js/issues/57","labels_url":"https://api.github.com/repos/graphql/graphql-relay-js/issues/57/labels{/name}","comments_url":"https://api.github.com/repos/graphql/graphql-relay-js/issues/57/comments","events_url":"https://api.github.com/repos/graphql/graphql-relay-js/issues/57/events","html_url":"https://github.com/graphql/graphql-relay-js/issues/57","id":124322851,"number":57,"title":"mutationWithClientId should support a description argument","user":{"login":"angelf","id":121845,"avatar_url":"https://avatars.githubusercontent.com/u/121845?v=3","gravatar_id":"","url":"https://api.github.com/users/angelf","html_url":"https://github.com/angelf","followers_url":"https://api.github.com/users/angelf/followers","following_url":"https://api.github.com/users/angelf/following{/other_user}","gists_url":"https://api.github.com/users/angelf/gists{/gist_id}","starred_url":"https://api.github.com/users/angelf/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/angelf/subscriptions","organizations_url":"https://api.github.com/users/angelf/orgs","repos_url":"https://api.github.com/users/angelf/repos","events_url":"https://api.github.com/users/angelf/events{/privacy}","received_events_url":"https://api.github.com/users/angelf/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-12-30T09:10:21Z","updated_at":"2016-02-02T11:22:45Z","closed_at":null,"body":"Mutations are just fields, so they can be documented with a 'description' as other fields. \r\n\r\nI think mutationWithClientId should support a 'description' arg and pass it on to the created field. "},"comment":{"url":"https://api.github.com/repos/graphql/graphql-relay-js/issues/comments/178518201","html_url":"https://github.com/graphql/graphql-relay-js/issues/57#issuecomment-178518201","issue_url":"https://api.github.com/repos/graphql/graphql-relay-js/issues/57","id":178518201,"user":{"login":"rogchap","id":270252,"avatar_url":"https://avatars.githubusercontent.com/u/270252?v=3","gravatar_id":"","url":"https://api.github.com/users/rogchap","html_url":"https://github.com/rogchap","followers_url":"https://api.github.com/users/rogchap/followers","following_url":"https://api.github.com/users/rogchap/following{/other_user}","gists_url":"https://api.github.com/users/rogchap/gists{/gist_id}","starred_url":"https://api.github.com/users/rogchap/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rogchap/subscriptions","organizations_url":"https://api.github.com/users/rogchap/orgs","repos_url":"https://api.github.com/users/rogchap/repos","events_url":"https://api.github.com/users/rogchap/events{/privacy}","received_events_url":"https://api.github.com/users/rogchap/received_events","type":"User","site_admin":false},"created_at":"2016-02-02T11:22:45Z","updated_at":"2016-02-02T11:22:45Z","body":"`mutationWithClientId` returns a simple object so it's easy to add a description for your mutations:\r\n\r\n``` javascript\r\ncreateUser: Object.assign(\r\n  { description: 'Creates a new user' },\r\n  mutationWithClientId({\r\n    // ... \r\n  })\r\n)\r\n```\r\n\r\nWhat's slightly harder is adding a description to the `Input` and `Payload` objects"}}