Content source
Keep source content reviewable in the repository.
Components
Use shared UI primitives for examples and callouts.
Build path
Validate generated pages through the normal site build.
MDX
Documentation content compiles into the same route and component system as authored pages.