🤖 Add mdbook documentation with mermaid and CI/CD

[ammario]

Overview

Sets up fast-building documentation using mdbook with mermaid diagram support and automatic deployment to GitHub Pages.

Features

• ✅ mdbook - Rust-based, blazingly fast builds
• ✅ Mermaid diagrams - Visual architecture documentation
• ✅ Link checking - Validates all links during build
• ✅ GitHub Pages CI/CD - Auto-deploys on push to main
• ✅ Example pages - Introduction, Getting Started, Architecture

Commands Added

bun docs              # Serve with hot reload + open browser
bun docs:build        # Build static site
bun docs:watch        # Watch for changes

CI/CD

• .github/workflows/docs.yml triggers on docs/ changes
• Deploys to https://ammarbandukwala.github.io/cmux
• Can be manually triggered

Structure

docs/
├── book.toml           # Config (mermaid + linkcheck)
├── README.md           # Documentation for contributors
├── src/
│   ├── SUMMARY.md      # Table of contents
│   ├── intro.md
│   ├── getting-started.md
│   └── architecture.md # With mermaid diagrams
└── book/               # Build output (gitignored)

---

Generated with cmux