Testing utility docs

[alessbell]

Closes #11775.

To do:

• Still writing the MSW section

[changeset-bot]

⚠️ No Changeset found

Latest commit: cdef3da

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[github-actions]

size-limit report 📦

Path	Size
dist/apollo-client.min.cjs	38.61 KB (0%)
import { ApolloClient, InMemoryCache, HttpLink } from "dist/main.cjs"	46.49 KB (0%)
import { ApolloClient, InMemoryCache, HttpLink } from "dist/main.cjs" (production)	44.04 KB (0%)
import { ApolloClient, InMemoryCache, HttpLink } from "dist/index.js"	34.16 KB (0%)
import { ApolloClient, InMemoryCache, HttpLink } from "dist/index.js" (production)	32.04 KB (0%)
import { ApolloProvider } from "dist/react/index.js"	1.24 KB (0%)
import { ApolloProvider } from "dist/react/index.js" (production)	1.22 KB (0%)
import { useQuery } from "dist/react/index.js"	5.27 KB (0%)
import { useQuery } from "dist/react/index.js" (production)	4.35 KB (0%)
import { useLazyQuery } from "dist/react/index.js"	5.51 KB (0%)
import { useLazyQuery } from "dist/react/index.js" (production)	4.58 KB (0%)
import { useMutation } from "dist/react/index.js"	3.51 KB (0%)
import { useMutation } from "dist/react/index.js" (production)	2.73 KB (0%)
import { useSubscription } from "dist/react/index.js"	3.19 KB (0%)
import { useSubscription } from "dist/react/index.js" (production)	2.38 KB (0%)
import { useSuspenseQuery } from "dist/react/index.js"	5.44 KB (0%)
import { useSuspenseQuery } from "dist/react/index.js" (production)	4.11 KB (0%)
import { useBackgroundQuery } from "dist/react/index.js"	4.92 KB (0%)
import { useBackgroundQuery } from "dist/react/index.js" (production)	3.58 KB (0%)
import { useLoadableQuery } from "dist/react/index.js"	5.03 KB (0%)
import { useLoadableQuery } from "dist/react/index.js" (production)	3.69 KB (0%)
import { useReadQuery } from "dist/react/index.js"	3.32 KB (0%)
import { useReadQuery } from "dist/react/index.js" (production)	3.26 KB (0%)
import { useFragment } from "dist/react/index.js"	2.29 KB (0%)
import { useFragment } from "dist/react/index.js" (production)	2.24 KB (0%)

[netlify]

✅ Deploy Preview for apollo-client-docs ready!

Name	Link
🔨 Latest commit	cdef3da
🔍 Latest deploy log	https://app.netlify.com/sites/apollo-client-docs/deploys/66292544ef04d9000726188e
😎 Deploy Preview	https://deploy-preview-11805--apollo-client-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[jerelmiller]

I'll leave most of the wording and such to Maria. Had some suggestions on structure and content, but otherwise this is a really great start to the doc! Feel free to ignore anything you disagree with as I trust your judgement on the intent. Thanks for writing this doc up!

[jerelmiller]

Would it make sense to also include a section about "When to use createSchemaFetch vs MSW"? Since these utilities are mutually exclusive, it might be best to state that somewhere explicitly in this doc to ensure those that aren't as familiar with those tools don't get confused and try and use both together.

[alessbell]

Really, really love this idea :) Will work on adding that shortly.

[alessbell]

Added in aebc3a5 let me know what you think!

[jerelmiller]

This seemed to render sorta weird, I think because of the way the docs add the external link icon. Do you know by chance if there is any way to avoid this?

[alessbell]

Hah yeah I just noticed this on another page. Will look into whether we can remove the link icon here 👍

[phryneas]

I would probably keep createSchemaFetch out of this heading as it is not required for msw, which is also under this heading.