Skip to content
Skip to content

Docs-as-Code Platform

This site treats documentation like release infrastructure. Content lives in Git, builds with Zensical, renders through the Material theme, versions with mike, and ships through GitHub Actions.

Sections

  • Guiding Principles

    Navigation, maintainability, and content rules that keep the site coherent.

    Open Principles

  • Workflow

    Local preview, release flow, and versioning steps.

    Open Workflow

  • Stack & Tooling

    Zensical, Material, mike, and the supporting CLI workflow.

    Open Stack

  • Quality & Style

    Writing standards, review habits, and consistency checks.

    Open Guide

  • AI Integrations

    Chat widget architecture, deployment, and integration constraints.

    Open AI Guides

  • Security Controls

    Preconditions, safeguards, and operational boundaries for AI features.

    Open Security

The Pipeline

Markdown
Content + metadata

Zensical
Config merge + build

MkDocs
Render + theme

GitHub Actions
CI + deploy

GitHub Pages
Hosted site

Operating rules

  • Docs stay in the repository with the code they explain.
  • Build and release steps stay short enough to understand without tribal knowledge.
  • Navigation reflects how people actually look for information, not just how files were created.
  • AI features only ship with explicit guardrails for logging, authentication, and abuse handling.

Current toolchain

  • Zensical is the primary build and local development path.
  • Material for MkDocs provides the theme, navigation model, and content components.
  • Mike preserves versioned releases without overwriting history.
  • GitHub Actions builds and deploys published versions to GitHub Pages.
  • doc-cli wraps common development and release tasks for local use.

Recent Changes

2026-04-28

High Contrast Minimalism V3 — Complete visual refresh: pure black/white palette, scroll-driven vines, animated 404, editorial timeline resume, and awwwards-level motion design.

2026-04-06

Elemental Ink V2 — Migrated from monumental minimalism to ATLA-inspired earth tones: teal accents, warm surfaces, flat hierarchy.

2026-03-01

Zensical Migration — Merged modular TOML config, added version selector, image optimizer with LQIP, and automated deployment pipeline.

Release loop

  1. Edit Markdown and supporting assets in docs/.
  2. Preview locally with make serve or ./doc-cli serve.
  3. Run make build before pushing changes.
  4. Open a pull request with Conventional Commit history.
  5. Publish a version with ./doc-cli deploy when the change is ready for release.