add a "memory management" documentation page

[phryneas]

I still need to incorporate all the feedback on Docblock comments from #11408 into this one.

The page can be reviewed here: https://deploy-preview-11415--apollo-client-docs.netlify.app/caching/memory-management

Checklist:

• If this PR contains changes to the library itself (not necessary for e.g. docs updates), please include a changeset (see CONTRIBUTING.md)
• If this PR is a new feature, please reference an issue where a consensus about the design was reached (not necessary for small changes)
• Make sure all of the significant new logic is covered by tests

[changeset-bot]

⚠️ No Changeset found

Latest commit: b4dfd1e

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.22 KB (0%)
import { ApolloClient, InMemoryCache, HttpLink } from "dist/main.cjs"	46.01 KB (0%)
import { ApolloClient, InMemoryCache, HttpLink } from "dist/main.cjs" (production)	43.56 KB (0%)
import { ApolloClient, InMemoryCache, HttpLink } from "dist/index.js"	33.97 KB (0%)
import { ApolloClient, InMemoryCache, HttpLink } from "dist/index.js" (production)	31.9 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.2 KB (0%)
import { useQuery } from "dist/react/index.js" (production)	4.27 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.39 KB (0%)
import { useSuspenseQuery } from "dist/react/index.js"	5.28 KB (0%)
import { useSuspenseQuery } from "dist/react/index.js" (production)	3.94 KB (0%)
import { useBackgroundQuery } from "dist/react/index.js"	4.75 KB (0%)
import { useBackgroundQuery } from "dist/react/index.js" (production)	3.39 KB (0%)
import { useLoadableQuery } from "dist/react/index.js"	4.98 KB (0%)
import { useLoadableQuery } from "dist/react/index.js" (production)	3.64 KB (0%)
import { useReadQuery } from "dist/react/index.js"	3.03 KB (0%)
import { useReadQuery } from "dist/react/index.js" (production)	2.97 KB (0%)
import { useFragment } from "dist/react/index.js"	2.1 KB (0%)
import { useFragment } from "dist/react/index.js" (production)	2.05 KB (0%)

[netlify]

✅ Deploy Preview for apollo-client-docs ready!

Name	Link
🔨 Latest commit	b4dfd1e
🔍 Latest deploy log	https://app.netlify.com/sites/apollo-client-docs/deploys/65834e4e95715e0008fac814
😎 Deploy Preview	https://deploy-preview-11415--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.

[phryneas]

The CacheSizes interface is not part of the normal @apollo/client entrypoint, so until now that was not part of the DocModel. This change creates a DocModel for all entrypoints combined.

It also moves some logic out as code was getting a bit confusing when everything was inlined down in buildReport

[phryneas]

@Meschreiber @alessbell @jerelmiller could I please get some feedback on this one? :)

[Meschreiber]

Beyond inline comments I would recommend removing the top H2 "Cache sizes" and bumping up all the subheader sizes (H3 -> H2, H4 -> H3).

"Cache sizes" applies to the entire document and should be mentioned in the page subtitle, and bumping up H4 -> H3 gives readers better visibility on the TOC.

[jerelmiller]

Caught a few minor things that needed changed for correctness, otherwise looks great! If @Meschreiber is happy, so am I!

[Meschreiber]

Thanks for the additional copy suggestions, @jerelmiller ! I also agree with the recommendation around using the minVersion component in addition to the front matter so didn't commit that suggestion directly. I've added one more clarification, otherwise, LGTM!

[jerelmiller]

🎉 Awesome stuff!