Source-Backed Reading Notes
Why this page matters
Architects should know which external sources support which decisions. This page maps stable, high-signal sources to the book's architecture topics.
Source map by topic
| Topic | Primary sources to consult | Use in the guide |
|---|---|---|
| browser runtime | MDN event loop, rendering, performance APIs | Part II runtime, Part VI performance |
| Web Vitals | web.dev Core Web Vitals, INP, LCP, CLS guidance | budgets, profiling, funnel capstone |
| accessibility | W3C WAI, WCAG 2.2, ARIA Authoring Practices | Part VIII, design-system contracts |
| browser security | OWASP Cheat Sheets, MDN CSP/CORS, web platform security docs | threat models, CSP, third-party reviews |
| React rendering | React docs for Server Components, Suspense, memoization/compiler guidance | Part III rendering boundaries |
| Next.js rendering | Next.js rendering, caching, routing, server actions documentation | route strategy and cache discussions |
| architecture decisions | ADR examples, fitness functions, evolutionary architecture ideas | Part I and Part XII artifacts |
| team architecture | Team Topologies, platform engineering writing | Part IX operating model and ownership |
| design systems | W3C accessibility, design token community reports, component API practice | Part VII and design-system reference |
| AI/GenUI safety | model eval, tool authorization, RAG citation, prompt injection guidance | Part XIII and GenUI reference |
How to add source notes to a chapter
Use this compact format:
## Source lens
- Source: what the source is authoritative for.
- Decision use: which architecture choice it supports.
- Limitation: where the source does not decide the product tradeoff.
Source-quality rules
- Prefer primary documentation for platform and framework behavior.
- Prefer standards bodies for accessibility and browser behavior.
- Prefer security organizations for threat categories and mitigations.
- Treat blog posts as examples unless they include reproducible data or official guidance.
- Do not cite a source as authority for a tradeoff it does not actually decide.
Review checklist
- Does the source support the decision being made?
- Is the source stable enough for a durable chapter?
- Is the chapter clear about where judgment is still required?
- Are source notes concise enough to maintain?
Exercises
- Add a source lens to one legacy chapter using this format.
- Identify one chapter that needs a primary source instead of a secondary article.
- Write one limitation statement for a framework documentation source.
Source lens
This page is the source-governance layer for Part XII citation standards, meta source map, and future guide maintenance.