This directory contains the source for cmux documentation built with mdbook.

# Serve docs with hot reload (opens in browser)
bun docs

# Build docs
bun docs:build

# Watch for changes (no server)
bun docs:watch

• ✅ Mermaid diagrams - Add diagrams with ```mermaid code blocks
• ✅ Link checking - Automatically validates all links during build
• ✅ GitHub Pages - Auto-deploys to https://cmux.io on push to main

docs/
├── book.toml        # mdbook configuration
├── src/
│   ├── SUMMARY.md   # Table of contents
│   └── *.md         # Documentation pages
└── book/            # Build output (gitignored)

1. Create a new .md file in src/
2. Add it to src/SUMMARY.md to make it appear in the sidebar
3. Use standard markdown + mermaid diagrams

See STYLE.md for documentation writing guidelines.

Docs are automatically built and deployed via .github/workflows/docs.yml when:

• Changes are pushed to main branch in the docs/ directory
• Workflow is manually triggered

The following tools are needed to build locally:

• mdbook (v0.4.52+)
• mdbook-mermaid (v0.16.0+)
• mdbook-linkcheck (v0.7.7+)

Install via cargo:

cargo install mdbook mdbook-mermaid mdbook-linkcheck
mdbook-mermaid install docs