Skip to content

docs: Add mdbook user guide with GitHub Pages deployment#2

Merged
zarubaf merged 3 commits intomainfrom
docs/mdbook-user-guide
Mar 25, 2026
Merged

docs: Add mdbook user guide with GitHub Pages deployment#2
zarubaf merged 3 commits intomainfrom
docs/mdbook-user-guide

Conversation

@zarubaf
Copy link
Copy Markdown
Owner

@zarubaf zarubaf commented Mar 25, 2026

Summary

  • 12-page mdbook user guide covering all Reflex features
  • GitHub Pages deployment workflow (auto-deploys on push to main)
  • mdbook build check added to CI (catches broken docs on PRs)

Pages

  • Introduction, Getting Started, Building from Source
  • Pipeline Viewer, Navigation & Cursors (multicursor, undo/redo)
  • Performance Counters (sparklines, heatmap, display modes)
  • Minimap (counter range, pipeline indicator, interactions)
  • Timeline Overlay, Queue Panels, Configuration (TOML presets)
  • Complete Keyboard Shortcuts reference

CI Changes

  • ci.yml: new docs job that builds mdbook on every push/PR
  • docs.yml: new workflow that deploys to GitHub Pages on push to main

Setup Required

After merging, enable GitHub Pages in repo settings:
Settings > Pages > Source: GitHub Actions

Post-Deploy Monitoring & Validation

No additional operational monitoring required: documentation-only change with no runtime impact.


Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

zarubaf and others added 3 commits March 25, 2026 11:30
Comprehensive documentation covering all Reflex features:
- Introduction, getting started, building from source
- Pipeline viewer, navigation, cursors, undo/redo
- Performance counters (sparklines, heatmap, display modes)
- Minimap (counter range, pipeline indicator, interactions)
- Timeline overlay, queue panels, configuration (TOML presets)
- Complete keyboard shortcut reference

Also updates README.md with docs link and CLAUDE.md with
counter/minimap architecture info.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Add docs job to CI that builds mdbook on every push/PR
- Add separate docs.yml workflow that deploys to GitHub Pages on push to main
- Uses mdbook v0.4.44 binary release for fast CI

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@zarubaf zarubaf merged commit 6e925cd into main Mar 25, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant