From 3d5d395d64f53b829f7dae345fdc8039edf87d8a Mon Sep 17 00:00:00 2001 From: hwillson Date: Wed, 26 Feb 2020 13:54:23 -0500 Subject: [PATCH] Migration guide update --- docs/source/migrating/apollo-client-3-migration.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/source/migrating/apollo-client-3-migration.md b/docs/source/migrating/apollo-client-3-migration.md index c8d1497452d..c818619a2d5 100644 --- a/docs/source/migrating/apollo-client-3-migration.md +++ b/docs/source/migrating/apollo-client-3-migration.md @@ -126,6 +126,8 @@ These packages provide the same functionality as their non-`@apollo` counterpart `apollo-link-rest` has also been updated to use `@apollo/client`, but does not use `@apollo/link-X` naming. It should still be referenced using `apollo-link-rest`, and updated to its `latest` version. +It is important to note that Apollo Client 3 no longer allows `@client` fields to be passed through a Link chain. While Apollo Client 2 made it possible to intercept `@client` fields in Link's like `apollo-link-state` and `@apollo/link-schema`, Apollo Client 3 enforces that `@client` fields are local only. This helps ensure Apollo Client's local state story is easier to understand, and prevents unwanted fields from accidentally ending up in network requests ([PR #5982](https://github.com/apollographql/apollo-client/pull/5982)). + ### graphql-anywhere The `graphql-anywhere` package’s functionality is no longer included with Apollo Client. You can continue to use the `graphql-anywhere` package, but Apollo no longer uses it and will not actively support it moving forward. @@ -169,7 +171,7 @@ Apollo Client 3.0 introduces powerful improvements to its caching system. Most o * [Configuring the cache](../caching/cache-configuration/) * [Interacting with cached data](../caching/cache-interaction/) -### Breaking changes +### Breaking cache changes The following cache changes are **not** backward compatible. Take them into consideration before you upgrade to Apollo Client 3.0.