Upgrade Guides

[okybr]

As a user of graphql-js, I want to use the latest, stable and secure version of it. I will check the release notes and for the exemplary version 16, I'll find an incomprehensible list of 54 breaking changes, along another 43 notes. I won't understand these and continue to look for a Upgrade Guide which is currently not present.

Hereby, I suggest to create an Upgrade Guide for graphql-js, beginning at version 15 or 16, in order to facilitate the maintenance of graphql-js for its users.

[IvanGoncharov]

@brainkim You wanted to work on this one, right?
We can put it in the docs/ folder and reference is release notes.

[sittingbool]

Is there a quick way to a getting started doc for the latest version? everything I can find wont work.

[saihaj]

@sittingbool unfortunately nothing yet : ( If you have specific questions please ask them in discussion and we can try to help https://github.com/graphql/graphql-js/discussions/new this would also help others who face similar issues in the process while we work on getting the new site #3269 and write some migration guides

[j0k3r]

Can we have an upgrade guide before the v17 is released?

[mannyistyping]

👋🏽 @IvanGoncharov & @saihaj

I have bandwidth and capacity to start chipping away at upgrade guides and more generally documentation where it would be helpful.

Unfortunately I do not know where to start, if there is a general direction that can be provided, I can start to open up issues and PRs related to those issues to close those out.

If there is a larger epic/project where these issues can be enumerated and tracked, I'd be happy to add them there.

Taking on small chunks of work to improve on the documentation front would be my approach.

[johannesrave]

i'm trying to bring a huge react project from node v12 and graphql 14 up to a semblance of current dependencies. i found migration guides for most of the major packages used, but not for graphql yet. did i miss anything?