docs: type generation for graphql servers

[sarahxsanders]

Adds new guide: Type Generation for GraphQL Servers

This is a part of the effort to expand GraphQL.js documentation

[github-actions]

Hi @sarahxsanders, I'm @github-actions bot happy to help you with this PR 👋

Supported commands

Please post this commands in separate comments and only one per comment:

• @github-actions run-benchmark - Run benchmark comparing base and merge commits for this PR
• @github-actions publish-pr-on-npm - Build package from this PR and publish it on NPM

[eddeee888]

Thank you @sarahxsanders !
I'm from the GraphQL Codegen team at The Guild. I've left some minor comments about our recommendation when using Codegen. Keen to hear your thoughts!

[JoviDeCroock]

I've fixed CI after rebasing this branch it will work again, apologies for the issues

[eddeee888]

Hi @sarahxsanders , thanks for making the changes to recommend presets.
Since preset config and benefits are very different from the base plugins, I wonder if there's a chance I could write those sections? Happy to provide direction too, but it's going to be very different from what we currently have 🙂

[sarahxsanders]

@eddeee888 you are absolutely welcome to write those sections! happy to collab if you want a review or anything

[eddeee888]

Thank you @sarahxsanders ! I'll draft something up this week, and let you know

[eddeee888]

Hi @sarahxsanders, I've left a draft here: https://github.com/graphql/graphql-js/pull/4376/files#r2091097002
Please let me know what you think!

[sarahxsanders]

Hi @sarahxsanders, I've left a draft here: https://github.com/graphql/graphql-js/pull/4376/files#r2091097002 Please let me know what you think!

Hello @eddeee888! Thanks so much for your draft, I have added that (only changed a few small nits for formatting/style guide stuff) in my latest commit

[eddeee888]

Thank you @sarahxsanders ! Feels like we are almost there!

I have some thoughts/feedback, keen to hear your opinions:

• We have not shown how to install Codegen packages in this doc. Do you think we should? I'm thinking it would be useful to readers who are new to GraphQL codegen.
• I have left recommendations to add markdown meta to show filenames to help readers visualise the file they are looking at

I'll share this with the codegen team to see if they have any more feedback!

[sarahxsanders]

Thank you @sarahxsanders ! Feels like we are almost there!

I have some thoughts/feedback, keen to hear your opinions:

• We have not shown how to install Codegen packages in this doc. Do you think we should? I'm thinking it would be useful to readers who are new to GraphQL codegen.
• I have left recommendations to add markdown meta to show filenames to help readers visualise the file they are looking at

I'll share this with the codegen team to see if they have any more feedback!

@eddeee888 Approved those suggestions, thank you! :)

I agree it could be helpful to show how to install the Codegen packages. Were you thinking just the core @graphql-codegen/cli, or also including common plugins like typescript and typescript-resolvers? I’m also not sure if we want to assume a particular setup like a specific framework for example. Curious how you’d approach that, and whether the Codegen team has any thoughts!!