chore(blog): add schema customization blog post release #12522
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
@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! |
marcysutton
suggested changes
Mar 13, 2019
|
|
||
| ## `createTypes` | ||
|
|
||
| `createTypes` can be used to define or fix your Node types GraphQL representation. |
There was a problem hiding this comment.
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.
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.
This is probably a newb question, but what is "SDL string"?
There was a problem hiding this comment.
Not a noob question--and we should always clarify our acronyms :) Will address!
There was a problem hiding this comment.
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
DSchau
commented
Mar 15, 2019
| 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.
Maybe:
Suggested change
| 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.
(Very open to tweaks here :))
DSchau
commented
Mar 15, 2019
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 :( |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
Opening for @freiksenet, since he's out on vacation!
Important to get this right--so 👀 appreciated!
Related Issues