-
Notifications
You must be signed in to change notification settings - Fork 10.3k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
chore(blog): add schema customization blog post release #12522
chore(blog): add schema customization blog post release #12522
Conversation
@marcysutton only if you have time--but this is a pretty meaningful feature, so would love your 👀 here if you have a few minutes in the next few days! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I left a few tweaky grammar things, and a question or two that would be good to answer for newbs. Great post!
|
||
## `createTypes` | ||
|
||
`createTypes` can be used to define or fix your Node types GraphQL representation. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can you add a few words explaining what "Node types GraphQL representation" means in case people don't already know?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've rephrased to
`createTypes` can be used to define, fix, or extend a Gatsby GraphQL type that represents some of your app's data.
docs/blog/2019-03-18-releasing-new-schema-customization/index.md
Outdated
Show resolved
Hide resolved
|
||
## The Type Builder API | ||
|
||
While `createTypes` accepts `graphql-js` types along with SDL string, we've also added an option to use `graphql-js` types so that user could create types with resolvers. However, `graphql-js` is pretty verbose and it's hard to refer to types that don't yet exist or don't exist in a current scope. Therefore, we decided to add another programmatic API, that combines brevity of SDL with flexibility of `graphql-js`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is probably a newb question, but what is "SDL string"?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not a noob question--and we should always clarify our acronyms :) Will address!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There is now a link to docs.
docs/blog/2019-03-18-releasing-new-schema-customization/index.md
Outdated
Show resolved
Hide resolved
docs/blog/2019-03-18-releasing-new-schema-customization/index.md
Outdated
Show resolved
Hide resolved
docs/blog/2019-03-18-releasing-new-schema-customization/index.md
Outdated
Show resolved
Hide resolved
docs/blog/2019-03-18-releasing-new-schema-customization/index.md
Outdated
Show resolved
Hide resolved
docs/blog/2019-03-18-releasing-new-schema-customization/index.md
Outdated
Show resolved
Hide resolved
This looks great. Some thoughts:
|
Co-Authored-By: DSchau <DSchau@users.noreply.github.com>
Co-Authored-By: DSchau <DSchau@users.noreply.github.com>
Co-Authored-By: DSchau <DSchau@users.noreply.github.com>
Co-Authored-By: DSchau <DSchau@users.noreply.github.com>
Co-Authored-By: DSchau <DSchau@users.noreply.github.com>
Co-Authored-By: DSchau <DSchau@users.noreply.github.com>
…au/gatsby into blog/releasing-schema-customization
npm install gatsby --save | ||
``` | ||
|
||
Next, continue reading below to see if any of the great, new features we've enabled scratch a particular itch. We feel very confident you're going to love these new features 💜 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe:
Next, continue reading below to see if any of the great, new features we've enabled scratch a particular itch. We feel very confident you're going to love these new features 💜 | |
Next, continue reading below to see if any of the great, new features we've enabled scratch a particular itch. We feel very confident they will 💜 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
(Very open to tweaks here :))
docs/blog/2019-03-18-releasing-new-schema-customization/index.md
Outdated
Show resolved
Hide resolved
I'll make it merge to schema branch so we can publish as soon as we merge. |
I'll merge and continue in #11480 cause I can't commit here :( |
Description
Opening for @freiksenet, since he's out on vacation!
Important to get this right--so 👀 appreciated!
Related Issues