From 9ffc6842d982305122a43ea3c886df0affb07c4c Mon Sep 17 00:00:00 2001 From: Calvin Cestari <146856+calvincestari@users.noreply.github.com> Date: Thu, 23 Oct 2025 15:21:19 -0700 Subject: [PATCH 1/5] Update copy --- docs/source/fetching/defer.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/source/fetching/defer.mdx b/docs/source/fetching/defer.mdx index 9023c7bddbb..06d401f54c7 100644 --- a/docs/source/fetching/defer.mdx +++ b/docs/source/fetching/defer.mdx @@ -3,13 +3,13 @@ title: 'Using the @defer directive in Apollo Kotlin' description: 'Fetch slower schema fields asynchronously' --- - + -**The `@defer` directive is currently [experimental](https://www.apollographql.com/docs/resources/product-launch-stages/#experimental-features) in Apollo Kotlin.** If you have feedback on it, please let us know via [GitHub issues](https://github.com/apollographql/apollo-kotlin/issues/new?assignees=&labels=Type%3A+Bug&template=bug_report.md) or in the [Kotlin Slack community](https://slack.kotl.in/). +The incremental delivery format used by `@defer` has not yet been standardized. There have been multiple proposals and Apollo Kotlin only supports [the format implemented by Apollo Router](https://www.apollographql.com/docs/graphos/routing/operations/defer#specification-status). - + -Apollo Kotlin provides experimental support of [the `@defer` directive](https://github.com/graphql/graphql-wg/blob/main/rfcs/DeferStream.md), which 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 [`@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 profile information as soon as it's available, instead of waiting for the friend fields to resolve. From 22182d32f37db7ab762dcf0bc611329a817f3359 Mon Sep 17 00:00:00 2001 From: Calvin Cestari <146856+calvincestari@users.noreply.github.com> Date: Thu, 23 Oct 2025 15:31:38 -0700 Subject: [PATCH 2/5] Apply changes from AI Style Review --- docs/source/fetching/defer.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/source/fetching/defer.mdx b/docs/source/fetching/defer.mdx index 06d401f54c7..48233c8b6b0 100644 --- a/docs/source/fetching/defer.mdx +++ b/docs/source/fetching/defer.mdx @@ -5,11 +5,11 @@ description: 'Fetch slower schema fields asynchronously' -The incremental delivery format used by `@defer` has not yet been standardized. There have been multiple proposals and Apollo Kotlin 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 Kotlin 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. +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 profile information as soon as it's available, instead of waiting for the friend fields to resolve. From a319ab37e7a46ffeb6689b3d299550b80f6921f9 Mon Sep 17 00:00:00 2001 From: Calvin Cestari <146856+calvincestari@users.noreply.github.com> Date: Fri, 24 Oct 2025 13:33:58 -0700 Subject: [PATCH 3/5] 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 48233c8b6b0..9e3d1c89baf 100644 --- a/docs/source/fetching/defer.mdx +++ b/docs/source/fetching/defer.mdx @@ -9,7 +9,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 profile information as soon as it's available, instead of waiting for the friend fields to resolve. From 63c9908b1b5674e87a1e67a590421465cdd320ba Mon Sep 17 00:00:00 2001 From: Calvin Cestari <146856+calvincestari@users.noreply.github.com> Date: Fri, 24 Oct 2025 14:32:42 -0700 Subject: [PATCH 4/5] 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 9e3d1c89baf..f2a3240ae30 100644 --- a/docs/source/fetching/defer.mdx +++ b/docs/source/fetching/defer.mdx @@ -5,7 +5,7 @@ description: 'Fetch slower schema fields asynchronously' -The incremental delivery format used by `@defer` isn't yet standardized. There have been multiple proposals and Apollo Kotlin 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 Kotlin 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 4fcd0e69c9c5445d186d6115892a6cc535de2734 Mon Sep 17 00:00:00 2001 From: Calvin Cestari <146856+calvincestari@users.noreply.github.com> Date: Mon, 27 Oct 2025 12:28:50 -0700 Subject: [PATCH 5/5] Add suggestion from Martin Co-authored-by: Martin Bonnin --- 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 f2a3240ae30..950d04d1987 100644 --- a/docs/source/fetching/defer.mdx +++ b/docs/source/fetching/defer.mdx @@ -5,7 +5,7 @@ description: 'Fetch slower schema fields asynchronously' -The incremental delivery format used by `@defer` isn't yet standardized. There have been multiple proposals and Apollo Kotlin 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 Kotlin 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/).