payload: {"action":"created","issue":{"url":"https://api.github.com/repos/gatsbyjs/gatsby/issues/18280","repository_url":"https://api.github.com/repos/gatsbyjs/gatsby","labels_url":"https://api.github.com/repos/gatsbyjs/gatsby/issues/18280/labels{/name}","comments_url":"https://api.github.com/repos/gatsbyjs/gatsby/issues/18280/comments","events_url":"https://api.github.com/repos/gatsbyjs/gatsby/issues/18280/events","html_url":"https://github.com/gatsbyjs/gatsby/issues/18280","id":503691263,"node_id":"MDU6SXNzdWU1MDM2OTEyNjM=","number":18280,"title":"[docs][guides] improve Schema Customization docs","user":{"login":"marcysutton","id":1045233,"node_id":"MDQ6VXNlcjEwNDUyMzM=","avatar_url":"https://avatars0.githubusercontent.com/u/1045233?v=4","gravatar_id":"","url":"https://api.github.com/users/marcysutton","html_url":"https://github.com/marcysutton","followers_url":"https://api.github.com/users/marcysutton/followers","following_url":"https://api.github.com/users/marcysutton/following{/other_user}","gists_url":"https://api.github.com/users/marcysutton/gists{/gist_id}","starred_url":"https://api.github.com/users/marcysutton/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/marcysutton/subscriptions","organizations_url":"https://api.github.com/users/marcysutton/orgs","repos_url":"https://api.github.com/users/marcysutton/repos","events_url":"https://api.github.com/users/marcysutton/events{/privacy}","received_events_url":"https://api.github.com/users/marcysutton/received_events","type":"User","site_admin":false},"labels":[{"id":460230446,"node_id":"MDU6TGFiZWw0NjAyMzA0NDY=","url":"https://api.github.com/repos/gatsbyjs/gatsby/labels/Hacktoberfest","name":"Hacktoberfest","color":"fcbfe3","default":false},{"id":214544675,"node_id":"MDU6TGFiZWwyMTQ1NDQ2NzU=","url":"https://api.github.com/repos/gatsbyjs/gatsby/labels/help%20wanted","name":"help wanted","color":"0e8a16","default":true},{"id":1500835389,"node_id":"MDU6TGFiZWwxNTAwODM1Mzg5","url":"https://api.github.com/repos/gatsbyjs/gatsby/labels/topic:%20GraphQL","name":"topic: GraphQL","color":"6ff7d3","default":false},{"id":459665181,"node_id":"MDU6TGFiZWw0NTk2NjUxODE=","url":"https://api.github.com/repos/gatsbyjs/gatsby/labels/type:%20documentation","name":"type: documentation","color":"0075ca","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2019-10-07T21:06:26Z","updated_at":"2019-10-07T22:10:09Z","closed_at":null,"author_association":"MEMBER","body":"## Summary\r\n\r\nThrough feedback, we've heard that the [Schema Customization docs](https://www.gatsbyjs.org/docs/schema-customization/) could use some improvement for understanding how to apply the concepts. For example:\r\n\r\n> \"Gives too specific of examples without really explaining how the concepts work. Having a difficult time applying schema customization to my own use case. (want to make a new connection based on MarkdownRemarkConnection)\"\r\n\r\n> \"it makes a bit of sense, but i really want to see it in action, and i'm not sure I can get a type builder working end to end in my project\"\r\n\r\nThe doc uses an example project, which is great. But it would be helpful to add some more ideas throughout the doc to help users understand how to apply the concepts to their own work (e.g. \"One use case for this approach would be ______\", \"You might apply this to do ____\", etc.)\r\n\r\nThis doc also needs to be updated to adhere to the [Gatsby Style Guide](https://www.gatsbyjs.org/contributing/gatsby-style-guide/#use-you-as-the-pronoun), as it uses \"our\" and \"we\" instead of focusing on the reader with \"you\" and \"your\".\r\n\r\n### Motivation\r\n\r\nWe want users of all skill levels to feel more comfortable using Schema Customization. It's a powerful API that we aren't quite explaining in a way that people can understand -- therefore its usefulness is limited to more advanced users. In general, adding examples of _why_ and _how_ to use something are just as important as the explanation of _what_ the thing is -- we've seen a similar situation with Gatsby Themes.\r\n\r\n### Related issues\r\n\r\nLoosely related to #14228, which is more focused on Gatsby Internals."},"comment":{"url":"https://api.github.com/repos/gatsbyjs/gatsby/issues/comments/539225764","html_url":"https://github.com/gatsbyjs/gatsby/issues/18280#issuecomment-539225764","issue_url":"https://api.github.com/repos/gatsbyjs/gatsby/issues/18280","id":539225764,"node_id":"MDEyOklzc3VlQ29tbWVudDUzOTIyNTc2NA==","user":{"login":"DaniTulp","id":18421761,"node_id":"MDQ6VXNlcjE4NDIxNzYx","avatar_url":"https://avatars3.githubusercontent.com/u/18421761?v=4","gravatar_id":"","url":"https://api.github.com/users/DaniTulp","html_url":"https://github.com/DaniTulp","followers_url":"https://api.github.com/users/DaniTulp/followers","following_url":"https://api.github.com/users/DaniTulp/following{/other_user}","gists_url":"https://api.github.com/users/DaniTulp/gists{/gist_id}","starred_url":"https://api.github.com/users/DaniTulp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DaniTulp/subscriptions","organizations_url":"https://api.github.com/users/DaniTulp/orgs","repos_url":"https://api.github.com/users/DaniTulp/repos","events_url":"https://api.github.com/users/DaniTulp/events{/privacy}","received_events_url":"https://api.github.com/users/DaniTulp/received_events","type":"User","site_admin":false},"created_at":"2019-10-07T22:10:09Z","updated_at":"2019-10-07T22:10:09Z","author_association":"NONE","body":"I can work on the Gatsby Style guide rules. I can try to add some more examples, but I am currently not experienced (yet) with all the ins and outs of the Schema Customization API."}}
other: {"actor":{"display_login":"DaniTulp"}}