diff --git a/docs/client-react-streaming.buildmanualdatatransport.md b/docs/client-react-streaming.buildmanualdatatransport.md index d0a76f52..1ea18b58 100644 --- a/docs/client-react-streaming.buildmanualdatatransport.md +++ b/docs/client-react-streaming.buildmanualdatatransport.md @@ -57,7 +57,7 @@ BuildArgs While this Data Transport enables streaming SSR, it has some conceptual drawbacks: -- It does not have a way of keeping your connection open if your application already finished, but there are still ongoing queries that might need to be awaited transported over. - This can happen if a component renders `useBackgroundQuery`, but does not read the `queryRef` with `useReadQuery` - These "cut off" queries will be restarted in the Browser once the browser's `load` event happens - If the `useInsertHtml` doesn't immediately flush data to the browser, the browser might already attain "newer" data through queries triggered by user interaction. - This delayed behaviour is the case with the Next.js `ServerInsertedHTMLContext` and in the example Vite implementation. - In this, case, older data from the server might overwrite newer data in the browser. - This is minimized by simulating ongoing queries in the browser once the information of a started query is transported over. If the browser would try to trigger the exact same query, query deduplication would make the browser wait for the server query to resolve instead. - For more timing-related details, see https://github.com/apollographql/apollo-client-nextjs/pull/9 +- It does not have a way of keeping your connection open if your application already finished, but there are still ongoing queries that might need to be transported over. - This can happen if a component renders `useBackgroundQuery`, but does not read the `queryRef` with `useReadQuery` - These "cut off" queries will be restarted in the browser once the browser's `load` event happens - If the `useInsertHtml` doesn't immediately flush data to the browser, the browser might already attain "newer" data through queries triggered by user interaction. - This delayed behaviour is the case with the Next.js `ServerInsertedHTMLContext` and in the example Vite implementation. - In this, case, older data from the server might overwrite newer data in the browser. This is minimized by simulating ongoing queries in the browser once the information of a started query is transported over. If the browser would try to trigger the exact same query, query deduplication would make the browser wait for the server query to resolve instead. - For more timing-related details, see https://github.com/apollographql/apollo-client-nextjs/pull/9 To fully work around these drawbacks, React needs to add "data injection into the stream" to it's public API, which is not the case today. We provide an \[example with a patched React version\](https://github.com/apollographql/apollo-client-nextjs/blob/main/integration-test/experimental-react) to showcase how that could look. diff --git a/docs/client-react-streaming.md b/docs/client-react-streaming.md index b7826693..23783d1e 100644 --- a/docs/client-react-streaming.md +++ b/docs/client-react-streaming.md @@ -138,7 +138,7 @@ Creates a "manual" Data Transport, to be used with `WrapApolloProvider`. > This export is only available in React Server Components -Ensures that during RSC for an ongoing request, you can always access the same instance of ApolloClient, while always returning a new instance of different requests. +Ensures that you can always access the same instance of ApolloClient during RSC for an ongoing request, while always returning a new instance for different requests. @@ -149,7 +149,7 @@ Ensures that during RSC for an ongoing request, you can always access the same i -Ensures that during RSC for an ongoing request, you can always access the same instance of ApolloClient, while always returning a new instance of different requests. +Ensures that you can always access the same instance of ApolloClient during RSC for an ongoing request, while always returning a new instance for different requests. diff --git a/docs/client-react-streaming.registerapolloclient.md b/docs/client-react-streaming.registerapolloclient.md index 0ce0be8f..6ee938b3 100644 --- a/docs/client-react-streaming.registerapolloclient.md +++ b/docs/client-react-streaming.registerapolloclient.md @@ -6,7 +6,7 @@ > This export is only available in React Server Components -Ensures that during RSC for an ongoing request, you can always access the same instance of ApolloClient, while always returning a new instance of different requests. +Ensures that you can always access the same instance of ApolloClient during RSC for an ongoing request, while always returning a new instance for different requests. **Signature:** diff --git a/docs/client-react-streaming.registerapolloclient_1.md b/docs/client-react-streaming.registerapolloclient_1.md index 78f9a1e4..2722e803 100644 --- a/docs/client-react-streaming.registerapolloclient_1.md +++ b/docs/client-react-streaming.registerapolloclient_1.md @@ -4,7 +4,7 @@ ## registerApolloClient() function -Ensures that during RSC for an ongoing request, you can always access the same instance of ApolloClient, while always returning a new instance of different requests. +Ensures that you can always access the same instance of ApolloClient during RSC for an ongoing request, while always returning a new instance for different requests. **Signature:** diff --git a/docs/experimental-nextjs-app-support.md b/docs/experimental-nextjs-app-support.md index 89c1c514..2436c8d2 100644 --- a/docs/experimental-nextjs-app-support.md +++ b/docs/experimental-nextjs-app-support.md @@ -122,7 +122,7 @@ Description > This export is only available in React Server Components -Ensures that during RSC for an ongoing request, you can always access the same instance of ApolloClient, while always returning a new instance of different requests. +Ensures that you can always access the same instance of ApolloClient during RSC for an ongoing request, while always returning a new instance for different requests. @@ -133,7 +133,7 @@ Ensures that during RSC for an ongoing request, you can always access the same i -Ensures that during RSC for an ongoing request, you can always access the same instance of ApolloClient, while always returning a new instance of different requests. +Ensures that you can always access the same instance of ApolloClient during RSC for an ongoing request, while always returning a new instance for different requests. diff --git a/docs/experimental-nextjs-app-support.registerapolloclient.md b/docs/experimental-nextjs-app-support.registerapolloclient.md index 5579cca2..015a8853 100644 --- a/docs/experimental-nextjs-app-support.registerapolloclient.md +++ b/docs/experimental-nextjs-app-support.registerapolloclient.md @@ -6,7 +6,7 @@ > This export is only available in React Server Components -Ensures that during RSC for an ongoing request, you can always access the same instance of ApolloClient, while always returning a new instance of different requests. +Ensures that you can always access the same instance of ApolloClient during RSC for an ongoing request, while always returning a new instance for different requests. **Signature:** diff --git a/docs/experimental-nextjs-app-support.registerapolloclient_1.md b/docs/experimental-nextjs-app-support.registerapolloclient_1.md index 1c03a90c..964745a3 100644 --- a/docs/experimental-nextjs-app-support.registerapolloclient_1.md +++ b/docs/experimental-nextjs-app-support.registerapolloclient_1.md @@ -4,7 +4,7 @@ ## registerApolloClient() function -Ensures that during RSC for an ongoing request, you can always access the same instance of ApolloClient, while always returning a new instance of different requests. +Ensures that you can always access the same instance of ApolloClient during RSC for an ongoing request, while always returning a new instance for different requests. **Signature:**