Skip to main content

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

  1. introduction.mdx - What is Monolex
  2. quickstart.mdx - Get running in 5 minutes
  3. installation.mdx - Download & setup
  4. architecture/overview.mdx - High-level architecture diagram

Phase 2: Architecture Deep Dive

  1. architecture/tauri-stack.mdx - Tauri + Rust + TypeScript
  2. architecture/session-actor.mdx - Lock-free concurrency
  3. architecture/5-tier-grid-mode.mdx - Grid Mode v2

Phase 3: Terminal Essentials

  1. terminal/pty-daemon.mdx - Daemon architecture
  2. terminal/alacritty-renderer.mdx - VTE parsing
  3. 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

  1. Korean → English: All source docs are in Korean. Translation needed for public docs.
  2. ASCII Diagrams: Keep the excellent ASCII architecture diagrams.
  3. Code Examples: Include Rust + TypeScript examples.
  4. Mintlify Components: Use <CodeGroup>, <Tabs>, <Card> for better UX.