Documentation content should compile into the same route and component system as authored pages.
Keep source content reviewable in the repository.
Use shared UI primitives for examples and callouts.
Validate generated pages through the normal site build.