Docs
Documentation
Engineering notes that explain how the personal site is built and why.
This folder documents the technical structure of the site, the content model, and the decisions that
shape the build. The material is written to be readable in the repository and rendered at /docs
when the site is built.
Use these pages as a companion to the source code when making changes to routing, content, or infrastructure.
Sections
- Tech stack overview
- Architecture and routing map
- Content pipeline and frontmatter conventions
- Decisions and tradeoffs
- Deployment and operational notes
Documentation map
Each page covers a specific slice of the architecture and tooling.
Core frameworks, libraries, and services that power the site.
/docs/tech-stackArchitectureHow pages, components, and content sources fit together.
/docs/architectureContent pipelineHow markdown becomes pages, feeds, and search data.
/docs/content-pipelineDecisions and tradeoffsWhy the site favors static generation and file-based content.
/docs/decisionsDeploymentBuild, hosting, and environment configuration.
/docs/deployment