Upgrade docs are severely lacking

[jagthedrummer]

Issue summary

I'm trying to upgrade to v10, which seems to break literally everything, and the docs are completely inadequate. They basically say "read the new library code and adjust your app accordingly".

Expected behavior

There should be docs that explicitly state which objects/methods have changed and it should suggest the new syntax to use.

Actual behavior

Developers are left to fend for themselves.

Steps to reproduce the problem

1. Have an app that works with v9
2. Upgrade to v10
3. 💥

Specifications

• shopify_api version: 10
• Shopify API version used (example: 2022-04):

[netwire88]

Agreed, it's virtually impossible to upgrade to v10 or later since the library no longer supports graphql-client, with no options to support it. This renders all existing GraphQL code not compatible. I'm not sure how Shopify engineering team can get rid (forget even deprecating) an existing core library and think it's ok.

[skillmatic-co]

+1, just posted #1049 airing my issues and frustrations as well. I'm probably going to have to downgrade.

We'll see if anyone from Shopify chimes in, cc: @paulomarg @andyw8

[skillmatic-co]

In the meantime do yourself a favor and:

gem 'shopify_app', '< 19.0.0'
gem 'shopify_api', '< 10.0.0'

But who knows how long this will last? I wasn't aware upgrading was going to require a complete refactoring of my entire app.

[github-actions]

This issue is stale because it has been open for 60 days with no activity. It will be closed if no further action occurs in 14 days.

[jagthedrummer]

Not stale. This bot sucks.

[github-actions]

This issue is stale because it has been open for 60 days with no activity. It will be closed if no further action occurs in 14 days.

[jagthedrummer]

Not stale. Bot still sucks.

[github-actions]

This issue is stale because it has been open for 60 days with no activity. It will be closed if no further action occurs in 14 days.

[jagthedrummer]

not stale, bot still sucks

[skillmatic-co]

Still cannot upgrade to v10+ due to these issues.

[nelsonwittwer]

Improving docs are the top priority of this sprint, especially upgrading to v10. This is a duplicate of #1103 so I'll close this issue and consolidate our discussions there. Thanks for your patience on this!