Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adding codegen deprecation message #3243

Merged
merged 2 commits into from
Sep 29, 2023
Merged

Conversation

BobaFetters
Copy link
Member

Adding deprecation message to ApolloCodegen to alert users in advance of the upcoming 1.6.0 changes.

@netlify
Copy link

netlify bot commented Sep 28, 2023

Deploy Preview for apollo-ios-docs canceled.

Name Link
🔨 Latest commit f59e9de
🔍 Latest deploy log https://app.netlify.com/sites/apollo-ios-docs/deploys/6515ec4190142e0007ac5352

@@ -5,6 +5,7 @@ import OrderedCollections
#if os(macOS)

/// A class to facilitate running code generation
@available(*, deprecated, message: "Starting with the upcoming 1.6.0 release, the code generation library will be its own SPM package which you will need to add as a dependency. For more details see here: https://github.com/apollographql/apollo-ios/issues/3240")
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can probably remove the word "upcoming" given that we want to release these in tandem? So that folks who are pedantic about no warnings can do the change to 1.6.0 immediately.

Copy link
Member

@calvincestari calvincestari Sep 28, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Or maybe not if the patch release will only be this deprecation. Then they have no motivation to stay on it and can rollback to the previous (current) release prior to the warning.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If we do end up shipping a subsequent patch to 1.5.x then maybe it would be prudent for the user to be able to hide this message with an environment variable

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the idea is we push this patch ahead of time? Maybe I misunderstood the purpose though

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ahead of 1.6.0 is fine but then the patch should only contain the deprecation otherwise people who want the other changes but no warnings couldn't stay on the patch release. If there are no other changes then they can see the message, decide they don't want the build warning and go back to the previous version. Once 1.6.0 is out they can catch-up and go from there.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not aware of any changes we have planned to ship in a patch release before 1.6.0 at this point.

@BobaFetters BobaFetters merged commit 56e94ba into main Sep 29, 2023
@BobaFetters BobaFetters deleted the codegen-deprecation-message branch September 29, 2023 19:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants