Skip to content

docs: clarify cache behavior across navigations - #98590

Draft
aurorascharff wants to merge 5 commits into
codex/optimize-static-shell-guidefrom
codex/cache-navigation-cache-guidance
Draft

docs: clarify cache behavior across navigations#98590
aurorascharff wants to merge 5 commits into
codex/optimize-static-shell-guidefrom
codex/cache-navigation-cache-guidance

Conversation

@aurorascharff

@aurorascharff aurorascharff commented Sep 11, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • document stable SWR cache keys so remounts and repeat navigations can reuse browser data
  • clarify how to scope use cache: private identities and handle browser-held output after writes
  • teach all three instant() test rigs to distinguish fresh-destination absence from hidden DOM retained during repeat or browser-back navigation
  • align the Partial Prefetching rigs with the shared server-lifecycle and conclusive-result rules from docs: add guide for optimizing the static shell #97737
  • ensure Partial Prefetching adoption tests target canonical destinations instead of redirecting links

This is stacked on #97737 and can be retargeted to canary after it merges.

Verification

  • focused Prettier check
  • focused Alex language lint
  • git diff --check
  • repository pre-commit lint-staged checks

@github-actions

github-actions Bot commented Sep 11, 2026 •

Copy link
Copy Markdown
Contributor

Tests Passed

Commit: e2fb0c6

@aurorascharff
aurorascharff marked this pull request as draft September 11, 2026 23:39

@SapanMozammel SapanMozammel left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good clarification on return-navigation testing patterns and webServer lifecycle.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants