The site gets easier to understand when every content type follows the same basic rules. Markdown gives us the body copy, frontmatter gives us the metadata, and the route file controls how the page feels on the screen.
Shared patterns
- a single source of truth for titles and descriptions
- predictable file-to-route mapping
- static prerendering for public content
Where to diverge
Docs can be dense, nested, and reference-heavy. Blog posts can be shorter, more narrative, and more date-driven.
That split keeps each section doing one job well.