[arv]

Everything Zero 1.11 needs in the docs, in one PR, so it can merge on release day: the release notes plus the feature docs they link to. This replaces #314, #318, #320, #321, #322, #323 and #324.

Commit	Was	Pages
'cached' result type	#318	queries
'initializing' connection state, new lifecycle diagram	#320	connection
Storage failures, zero.kvStore	#321	connection, react-native
Query identity	#322	react
Mutator return values, tx.retryOn(), isolation levels	#323	mutators, server-zql
Config: legacy queries, operator password, readiness, hydration limits; corrected defaults (including the one-week CVR GC default from #314); removed VFS options	#324	zero-cache-config, deprecated/ad-hoc-queries, debug/slow-queries
Release notes, including the Mac and React Native benchmark results	new	release-notes/1.11, release-notes/index
Plainer wording for the release notes and the feature docs	new	the pages above
API Reference link to 1.11.0	new	lib/routes-config.ts
Search index	regenerated after each content change	assets/search-index.json

The release notes link straight to the new sections. I checked every /docs/... link and anchor in the changed pages against the headings on this branch, and every changed page compiles with @mdx-js/mdx.

Open before merging:

• React Native benchmark results
• Decide whether partial indexes are announced: not in 1.11, since they are off by default
• Replication-manager SIGTERM drain: fixed in code; no docs change needed
• Redraw the lifecycle diagram with the initializing state (now lifecycle.svg)
• Re-sign the commits. They were signed by a cloud session key that "Verify Signed Commit Authors" doesn't accept:

  git fetch origin arv/docs-1.11 && git checkout arv/docs-1.11
  git rebase -x 'git commit --amend --no-edit -S' origin/main
  git push --force-with-lease origin arv/docs-1.11

• Regenerate the search index again if anything else changes before merging
• After 1.11.0 is on npm, check that the API Reference link (https://npmx.dev/package-docs/@rocicorp/zero/v/1.11.0#class-Zero) loads

🤖 Generated with Claude Code

https://claude.ai/code/session_01RRckJnCeGsYg9nCJSxBgTJ

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
zero-docs	Ready	Preview	Oct 16, 2026 10:41am UTC

[arv]

Verify Signed Commit Authors fails on all 8 commits because a cloud Claude Code session signed them with its own SSH key, which isn't in rocicorp/.github's allowed signers. The docs change itself is fine, and a re-run won't help. Re-signing every commit at once with an allowed key fixes it:

git fetch origin arv/docs-1.11 && git checkout arv/docs-1.11
git rebase -x 'git commit --amend --no-edit -S' origin/main
git push --force-with-lease origin arv/docs-1.11

---

Generated by Claude Code

[Copilot]

🟡 Changes recommended

Unresolved documentation accuracy issues remain in release-note claims and configuration guidance.

4 open findings

• Support or remove the React Native cold-start speed claim · New
• Add evidence for RN aggregate benchmarks or narrow the claims · New
• Refer to pre-v5 backups as legacy WAL backups · New
• Update lifecycle image to show initializing before connecting · New

What changed in this PR

Documents Zero 1.11 features, configuration changes, migration guidance, and release notes.

Changes:

• Adds client, server, mutator, query, and connection documentation.
• Updates configuration options and defaults.
• Adds release notes and related documentation links.

File	Summary
contents/​docs/​zero-cache-config.mdx	Documents new options and corrected defaults.
contents/​docs/​server-zql.mdx	Adds transaction isolation-level guidance.
contents/​docs/​release-notes/​index.mdx	Links to the 1.11 release notes.
contents/​docs/​release-notes/​1.11.mdx	Adds 1.11 features, performance data, fixes, and breaking changes.
contents/​docs/​react.mdx	Documents query identity and interning.
contents/​docs/​react-native.mdx	Links to storage-failure guidance.
contents/​docs/​queries.mdx	Documents cached results and preload behavior.
contents/​docs/​mutators.mdx	Documents retries and returned data.
contents/​docs/​deprecated/​ad-hoc-queries.mdx	Documents legacy-query configuration.
contents/​docs/​debug/​slow-queries.mdx	Documents operator-password access.
contents/​docs/​connection.mdx	Documents initialization and storage failures.

🧠 Review effort: Lite

---

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[arv]

Copilot review (thread replies are blocked by a pending review, so answering here):

• "v4 backups" (r4281201897): fixed in ccab907. It now says "To keep writing legacy WAL backups with Litestream v0.3", matching zero-cache-config.
• React Native aggregate (r4281201839): the count was wrong, and ccab907 fixes it. The 56 included three JSON.parse control benchmarks. Without them there are 53 benchmarks with a geometric mean of 1.68x, so the text now says about 1.7x. 48 of the 53 improved by more than 5%. The ranges are from the same run: hydration 1.64x to 4.77x, pushes 1.25x to 1.84x, transactions of edits 1.23x to 2.23x. The chart shows five common operations, not all 53.
• React Native cold start, about 8x (r4281201776): this is the same cold-boot benchmark run on Hermes (iPhone 17 Pro simulator, release build), 58,768 ms to 7,187 ms, which is 8.18x. It isn't charted because the absolute React Native times don't represent a real app. The benchmark pushes about 30,000 rows one at a time through Hermes' interpreter, while the real client bulk-loads them, so only the ratio is meaningful. The claim stays as is.
• Lifecycle image (r4281201985): fixed in e275345 and 8775725. lifecycle.png is replaced by lifecycle.svg, which starts in initializing.

---

Generated by Claude Code