Benchmark Deep Content
These pages are the quality bar for “deep dives”: contract-first, mechanism-backed, counterexample-driven, and operational.
How to use this index
- Start with Benchmarks when you want the most reliable mental model.
- Use Candidates as next reads; they are useful but may still have missing link closure or weaker counterexamples.
- Needs work indicates pages that are valuable but should be tightened to match the benchmark rubric.
Benchmarks
If you read only a few pages, start here.
- Suspense (deep dive) — Defines the semantics/invariants, boundary placement strategy, and the caching prerequisite; includes pitfalls and next links.
- Actions (React 19) — Treats submissions as contracts: pending/error/success; explains progressive enhancement prerequisites and common failure modes.
- Concurrency and Suspense — Explains scheduling, render-vs-commit invariants, priority (transitions), and how boundaries shape UX.
Candidates
Good next reads once you have the basics; some pages may still be missing link closure or counterexamples.
- Context (deep dive) — Focuses on value stability, rerender blast radius, and practical splitting heuristics.
- Close the loop with Reference/Guides/Explanation links.
- SSR & RSC — Frames rendering as an architectural decision with boundaries, migration guidance, and tradeoffs.
- Add explicit links to related Learn/Reference/Explanation pages.
- React Server Components — Long-form overview of Server vs Client Components, constraints, and migration patterns.
- Tighten claims and prerequisites; add link closure to Guides/Explanation.
- Performance (guides) — Measurement-driven workflow and cost/benefit framing; emphasizes avoiding random memoization.
- Add pointers to key Reference APIs (Profiler, memo, useMemo/useCallback, transitions).
Needs work
These pages are useful, but not yet at the benchmark bar.
- Performance (learn) — Covers a broad set of optimization tactics and examples.
- Reframe around “measure first” and invariants; reduce slogan-like claims.
- Add counterexamples and link closure to Guides/Reference/Explanation.
- Advanced forms — Broad and practical coverage of forms, validation, and complex scenarios.
- Add stronger contract/TL;DR, a counterexample section, and explicit links to Actions/Reference.
Contribute
Want to write or upgrade a deep dive? Follow the rubric on Contributing.