The guide is designed to be easy to read, verify, and extend. Each topic is an MDX file; docs.json controls its place in the navigation.
Improve a topic
- Start with a concrete question or limitation.
- Explain why the simpler design breaks.
- Show the component or decision that addresses it.
- Include costs, limitations, and source links.
Do not present illustrative examples as measured benchmarks or infer confirmed product internals from a design exercise. Keep source-specific caveats beside the claim.
Preview locally
Open http://localhost:3001. Changes to MDX pages update in the preview.
Validate changes
Add new pages to docs.json. Keep the learning path and next-topic links consistent with the intended reading order. 
