graphql-js icon indicating copy to clipboard operation
graphql-js copied to clipboard

Upgrade Guides

Open okybr opened this issue 4 years ago • 6 comments

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.

okybr avatar Nov 09 '21 12:11 okybr

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

IvanGoncharov avatar Nov 09 '21 13:11 IvanGoncharov

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

sittingbool avatar Nov 15 '21 12:11 sittingbool

@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

saihaj avatar Nov 15 '21 12:11 saihaj

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

j0k3r avatar Aug 25 '22 08:08 j0k3r

👋🏽 @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.

mannyistyping avatar Aug 06 '23 19:08 mannyistyping

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?

johannesrave avatar Sep 25 '23 17:09 johannesrave