Monolex Documentation Structure Proposal
Source Analysis: /monolex/.claude/skills/monolex-architect/docs/
Main Chapters (18 files)
Database Documentation (5 files)
Deep Dive Series
multi-tab-rendering/ (34 chapters)
Comprehensive terminal rendering analysis comparing Alacritty, Ghostty, and Monolex:- Architecture & Data Integrity (1-8)
- VTE Parser & ANSI Escape (9-12)
- Grid & Scrollback (13-16)
- Rendering Pipeline (17-19)
- Input & IME (20-23)
- Font & GPU (24-26)
- Window/Tab Management (27-28)
- Configuration & Performance (29-30)
- Tauri & Actor Patterns (31-34)
terminal-internals-deep-dive/ (30 chapters)
Technical deep dives on terminal internals:- Backpressure & Architecture (1-7)
- Color, Cursor, Modes (8-12)
- Protocols & Selection (13-16)
- Rendering Pipelines (17-19)
- Input Integration (20-22)
- Font & GPU (23-25)
- System Integration (26-30)
ux-ai-native-terminal/
Research on AI-native terminal UX:- 50-Step Analysis across 5 threads
- BSU/ESU comparison
- Selection mechanisms
- Parser-grid interfaces
- Terminal comparisons (Alacritty, Ghostty, WezTerm, xterm.js)
Proposed Mintlify Navigation Structure
Implementation Priority
Phase 1: Core Documentation
- introduction.mdx - What is Monolex
- quickstart.mdx - Get running in 5 minutes
- installation.mdx - Download & setup
- architecture/overview.mdx - High-level architecture diagram
Phase 2: Architecture Deep Dive
- architecture/tauri-stack.mdx - Tauri + Rust + TypeScript
- architecture/session-actor.mdx - Lock-free concurrency
- architecture/5-tier-grid-mode.mdx - Grid Mode v2
Phase 3: Terminal Essentials
- terminal/pty-daemon.mdx - Daemon architecture
- terminal/alacritty-renderer.mdx - VTE parsing
- terminal/grid-system.mdx - Grid & buffer
Phase 4: Complete Documentation
- Remaining sections based on user demand
Key Stats
Total Source Files: 100+
Recommended Initial Pages: 10-15
Full Documentation: 50+ pages
Notes
- Korean → English: All source docs are in Korean. Translation needed for public docs.
- ASCII Diagrams: Keep the excellent ASCII architecture diagrams.
- Code Examples: Include Rust + TypeScript examples.
- Mintlify Components: Use
<CodeGroup>,<Tabs>,<Card>for better UX.