From f1745f548c5ac848d5a4d1a7fd2228aded3dfae4 Mon Sep 17 00:00:00 2001 From: Calvin Cestari <146856+calvincestari@users.noreply.github.com> Date: Thu, 23 Oct 2025 15:20:18 -0700 Subject: [PATCH 1/6] Update copy --- docs/source/fetching/defer.mdx | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/source/fetching/defer.mdx b/docs/source/fetching/defer.mdx index 565562b85..bc51c4ca1 100644 --- a/docs/source/fetching/defer.mdx +++ b/docs/source/fetching/defer.mdx @@ -2,9 +2,13 @@ title: Using the @defer directive in Apollo iOS --- -> ⚠️ **The `@defer` directive is currently an [experimental feature](https://www.apollographql.com/docs/resources/release-stages/#experimental-features) in Apollo iOS and is available for use from version 1.14.0.** If you have feedback on the feature, please let us know via a new [GitHub issue](https://github.com/apollographql/apollo-ios/issues/new?assignees=&labels=bug%2Cneeds+investigation&projects=&template=bug_report.yaml) or search through any [existing `@defer`-related issues](https://github.com/apollographql/apollo-ios/issues?q=is%3Aissue+is%3Aopen+%22defer%22). + -The [`@defer` directive](https://github.com/graphql/graphql-wg/blob/main/rfcs/DeferStream.md) enables your queries to receive data for specific fields asynchronously. This is helpful whenever some fields in a query take much longer to resolve than the others. +The incremental delivery format used by `@defer` has not yet been standardized. There have been multiple proposals and Apollo iOS only supports [the format implemented by Apollo Router](https://www.apollographql.com/docs/graphos/routing/operations/defer#specification-status). + + + +The [`@defer` directive](https://github.com/graphql/graphql-wg/blob/main/rfcs/DeferStream.md) enables your queries to receive data for specific fields *incrementally*, instead of receiving all field data at the same time. This is helpful whenever some fields in a query take much longer to resolve than the others. For example, let's say we're building a social media application that can quickly fetch a user's basic profile information, but retrieving that user's friends takes longer. If we include all of those fields in a single query we want to be able to display the basic profile information as soon as it's available instead of waiting for the `friends` field to resolve. From 956994839aaa9ced214457456afaaead22ddf9ae Mon Sep 17 00:00:00 2001 From: Calvin Cestari <146856+calvincestari@users.noreply.github.com> Date: Thu, 23 Oct 2025 15:28:02 -0700 Subject: [PATCH 2/6] Apply suggestion from AI Style Review --- docs/source/fetching/defer.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/fetching/defer.mdx b/docs/source/fetching/defer.mdx index bc51c4ca1..3c2f3b655 100644 --- a/docs/source/fetching/defer.mdx +++ b/docs/source/fetching/defer.mdx @@ -4,7 +4,7 @@ title: Using the @defer directive in Apollo iOS -The incremental delivery format used by `@defer` has not yet been standardized. There have been multiple proposals and Apollo iOS only supports [the format implemented by Apollo Router](https://www.apollographql.com/docs/graphos/routing/operations/defer#specification-status). +The incremental delivery format used by `@defer` isn't yet standardized. There have been multiple proposals, and Apollo iOS only supports [the format implemented by Apollo Router](https://www.apollographql.com/docs/graphos/routing/operations/defer#specification-status). From be107297a66a36b0bb00ad1043b5da41d95d6135 Mon Sep 17 00:00:00 2001 From: Calvin Cestari <146856+calvincestari@users.noreply.github.com> Date: Thu, 23 Oct 2025 15:30:35 -0700 Subject: [PATCH 3/6] Apply suggestion from AI Style Review --- docs/source/fetching/defer.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/fetching/defer.mdx b/docs/source/fetching/defer.mdx index 3c2f3b655..3dce446e0 100644 --- a/docs/source/fetching/defer.mdx +++ b/docs/source/fetching/defer.mdx @@ -8,7 +8,7 @@ The incremental delivery format used by `@defer` isn't yet standardized. There h -The [`@defer` directive](https://github.com/graphql/graphql-wg/blob/main/rfcs/DeferStream.md) enables your queries to receive data for specific fields *incrementally*, instead of receiving all field data at the same time. This is helpful whenever some fields in a query take much longer to resolve than the others. +The [`@defer` directive](https://github.com/graphql/graphql-wg/blob/main/rfcs/DeferStream.md) enables your queries to receive data for specific fields incrementally, instead of receiving all field data at the same time. This is helpful whenever some fields in a query take much longer to resolve than the others. For example, let's say we're building a social media application that can quickly fetch a user's basic profile information, but retrieving that user's friends takes longer. If we include all of those fields in a single query we want to be able to display the basic profile information as soon as it's available instead of waiting for the `friends` field to resolve. From 76e98c49c2bb96c570882fac4a19829123131e22 Mon Sep 17 00:00:00 2001 From: Calvin Cestari <146856+calvincestari@users.noreply.github.com> Date: Fri, 24 Oct 2025 14:33:45 -0700 Subject: [PATCH 4/6] Apply suggestion from @phryneas --- docs/source/fetching/defer.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/fetching/defer.mdx b/docs/source/fetching/defer.mdx index 3dce446e0..6060df139 100644 --- a/docs/source/fetching/defer.mdx +++ b/docs/source/fetching/defer.mdx @@ -4,7 +4,7 @@ title: Using the @defer directive in Apollo iOS -The incremental delivery format used by `@defer` isn't yet standardized. There have been multiple proposals, and Apollo iOS only supports [the format implemented by Apollo Router](https://www.apollographql.com/docs/graphos/routing/operations/defer#specification-status). +The incremental delivery format used by `@defer` isn't yet standardized. There have been multiple proposals and Apollo iOS only supports [the format implemented by Apollo Router](https://www.apollographql.com/docs/graphos/routing/operations/defer#specification-status), which is described in this [specification](https://specs.apollo.dev/incremental/v0.1/). From 9e8fef02647ff1c3f21f0b79edf2503c7bee891c Mon Sep 17 00:00:00 2001 From: Calvin Cestari <146856+calvincestari@users.noreply.github.com> Date: Fri, 24 Oct 2025 14:34:37 -0700 Subject: [PATCH 5/6] Apply suggestion from AI Style Review --- docs/source/fetching/defer.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/fetching/defer.mdx b/docs/source/fetching/defer.mdx index 6060df139..0e3be5aa9 100644 --- a/docs/source/fetching/defer.mdx +++ b/docs/source/fetching/defer.mdx @@ -8,7 +8,7 @@ The incremental delivery format used by `@defer` isn't yet standardized. There h -The [`@defer` directive](https://github.com/graphql/graphql-wg/blob/main/rfcs/DeferStream.md) enables your queries to receive data for specific fields incrementally, instead of receiving all field data at the same time. This is helpful whenever some fields in a query take much longer to resolve than the others. +The [`@defer` directive](https://github.com/graphql/graphql-wg/blob/main/rfcs/DeferStream.md) enables your queries to receive data for specific fields incrementally, instead of receiving all field data at the same time. This is helpful when some fields in a query take much longer to resolve than others. For example, let's say we're building a social media application that can quickly fetch a user's basic profile information, but retrieving that user's friends takes longer. If we include all of those fields in a single query we want to be able to display the basic profile information as soon as it's available instead of waiting for the `friends` field to resolve. From fce9c2b38a5fbf53f86c286a81b088551624a603 Mon Sep 17 00:00:00 2001 From: Calvin Cestari <146856+calvincestari@users.noreply.github.com> Date: Mon, 27 Oct 2025 12:31:27 -0700 Subject: [PATCH 6/6] Apply suggestion from @calvincestari --- docs/source/fetching/defer.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/fetching/defer.mdx b/docs/source/fetching/defer.mdx index 0e3be5aa9..bfa206e9e 100644 --- a/docs/source/fetching/defer.mdx +++ b/docs/source/fetching/defer.mdx @@ -4,7 +4,7 @@ title: Using the @defer directive in Apollo iOS -The incremental delivery format used by `@defer` isn't yet standardized. There have been multiple proposals and Apollo iOS only supports [the format implemented by Apollo Router](https://www.apollographql.com/docs/graphos/routing/operations/defer#specification-status), which is described in this [specification](https://specs.apollo.dev/incremental/v0.1/). +The incremental delivery format used by `@defer` [isn't yet standardized](https://github.com/graphql/defer-stream-wg). Apollo iOS supports [the format implemented by Apollo Router](https://www.apollographql.com/docs/graphos/routing/operations/defer#specification-status), which is described in this [specification](https://specs.apollo.dev/incremental/v0.1/).