Sets up a professional documentation website for HyperView using MkDocs with Material theme, deployable to GitHub Pages at https://hackerroomai.github.io/HyperView.

Changes

• Documentation Structure: 15+ pages organized into Getting Started, User Guide, Concepts, API Reference, and Development sections

  • Converted existing markdown docs (architecture.md, datasets.md) into comprehensive guides
  • Preserved interactive Poincaré disk demo as embedded HTML
  • Added mathematical explanations with LaTeX for hyperbolic geometry

• MkDocs Configuration (mkdocs.yml): Material theme with light/dark mode, search, code highlighting, and responsive navigation

• GitHub Actions Workflow (.github/workflows/docs.yml): Auto-builds and deploys on push to main

  • Installs mkdocs-material
  • Copies assets to docs directory
  • Builds static site
  • Deploys to GitHub Pages

• Setup Guides:

  • GITHUB_PAGES_SETUP.md: Quick 3-step enablement instructions
  • DOCUMENTATION.md: Local development and customization guide

Activation Required

Enable GitHub Pages in repository settings:

1. Navigate to Settings → Pages
2. Set Source to "GitHub Actions"
3. Merge PR to trigger first deployment

Site will be live at https://hackerroomai.github.io/HyperView after merge.

Local Preview

pip install mkdocs-material
mkdocs serve  # http://127.0.0.1:8000

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.