build: exclude generated markdown from git, update CI/CD docs

- Update .gitignore to exclude docs/mindmaps/*.md (rule-based)
- Update CI/CD to generate both Markdown and HTML mindmaps
- Remove 9 generated markdown files from git tracking
- Update docs/GITHUB_PAGES_SETUP.md with:
  - New workflow configuration
  - Version control summary table
  - Updated directory structure
  - Complete workflow diagram

Rule-based files are now fully generated by CI/CD.
Only AI-generated and manual files remain in version control.

Author: lufftw

.github/workflows/deploy-pages.yml

@@ -40,8 +40,9 @@ jobs:
         run: |
           pip install -r requirements.txt
       
-      - name: Generate Mind Maps (HTML)
+      - name: Generate Mind Maps (Markdown + HTML)
         run: |
+          python tools/generate_mindmaps.py
           python tools/generate_mindmaps.py --html
       
       - name: Build MkDocs site

.gitignore

@@ -45,12 +45,19 @@ Thumbs.db
 # MkDocs build output
 site/
 
-# Generated HTML mindmaps (use --html to regenerate)
-# Ignore all files in docs/pages/ except AI mindmaps
+# Generated mindmaps (regenerated by CI/CD)
+# ============================================
+# Rule-based mindmaps are generated from ontology data
+# Only AI-generated mindmaps are tracked (require API key, have cost)
+
+# Ignore generated HTML mindmaps
 docs/pages/**
-# But track AI-generated mindmaps (manually generated and committed)
 !docs/pages/mindmaps/
 !docs/pages/mindmaps/neetcode_ontology_ai_*.html
-# Track AI mindmap Markdown files
+
+# Ignore generated Markdown mindmaps
+docs/mindmaps/*.md
+!docs/mindmaps/index.md
+!docs/mindmaps/README.md
 !docs/mindmaps/neetcode_ontology_ai_*.md
 

docs/GITHUB_PAGES_SETUP.md

@@ -31,33 +31,37 @@ This guide explains how to deploy mind maps to GitHub Pages with full interactiv
 neetcode/
 ├── docs/
 │   ├── mindmaps/
-│   │   ├── index.md                    # Mind map index
-│   │   ├── pattern_hierarchy.md        # Static Markdown version
-│   │   ├── algorithm_usage.md
+│   │   ├── index.md                    # Mind map index (tracked)
+│   │   ├── README.md                   # Documentation (tracked)
+│   │   ├── neetcode_ontology_ai_*.md   # AI mind maps (tracked)
+│   │   ├── pattern_hierarchy.md        # Rule-based (gitignored, CI/CD generates)
+│   │   ├── algorithm_usage.md          # Rule-based (gitignored, CI/CD generates)
 │   │   └── ...
 │   │
-│   ├── pages/                          # 🆕 GitHub Pages root (gitignored)
-│   │   ├── mindmaps/                   # Interactive HTML mind maps
-│   │   │   ├── pattern_hierarchy.html
+│   ├── pages/                          # GitHub Pages root (mostly gitignored)
+│   │   ├── mindmaps/
+│   │   │   ├── neetcode_ontology_ai_*.html  # AI (tracked)
+│   │   │   ├── pattern_hierarchy.html       # Rule-based (gitignored)
 │   │   │   └── ...
-│   │   └── ...
+│   │   └── assets/                     # Shared assets (gitignored)
 │   │
 │   ├── stylesheets/                    # Custom CSS
 │   ├── index.md                        # Homepage (includes README.md)
 │   ├── index_zh-TW.md                  # Homepage (Traditional Chinese)
-│   └── GITHUB_PAGES_SETUP.md          # This file
+│   └── GITHUB_PAGES_SETUP.md           # This file
 │
 ├── tools/
 │   ├── generate_mindmaps.py            # Generate from ontology
+│   ├── generate_mindmaps_ai.py         # AI mind map generator
 │   ├── text_to_mindmap.py              # Generate from any text
 │   └── generate_mindmaps.toml          # Configuration
 │
 ├── .github/
 │   └── workflows/
-│       └── deploy-pages.yml            # 🆕 Auto deployment
+│       └── deploy-pages.yml            # Auto deployment workflow
 │
 ├── mkdocs.yml                          # MkDocs configuration
-└── site/                               # 🆕 MkDocs build output (gitignored)
+└── site/                               # MkDocs build output (gitignored)
 ```
 
 ---
@@ -102,7 +106,9 @@ python tools/generate_mindmaps.py --html
 python tools/generate_mindmaps.py --html --autoloader
 ```
 
-**Note:** Generated HTML files are saved to `docs/pages/mindmaps/` (gitignored).
+**Note:** Generated files are gitignored and regenerated by CI/CD:
+- Markdown: `docs/mindmaps/*.md` (except `index.md`, `README.md`, AI files)
+- HTML: `docs/pages/mindmaps/*.html` (except AI files)
 
 ---
 
@@ -287,17 +293,17 @@ The `.github/workflows/deploy-pages.yml` file handles automatic deployment:
 
 ```yaml
 # .github/workflows/deploy-pages.yml
-name: Deploy Documentation to GitHub Pages
+name: Deploy Documentation
 
 on:
   push:
     branches: [main]
     paths:
       - 'docs/**'
-      - 'mkdocs.yml'
-      - 'requirements.txt'
       - 'ontology/**'
       - 'meta/**'
+      - 'tools/generate_mindmaps.py'
+      - 'mkdocs.yml'
   workflow_dispatch:  # Allow manual trigger
 
 permissions:
@@ -324,15 +330,22 @@ jobs:
       - name: Install dependencies
         run: pip install -r requirements.txt
 
-      - name: Generate rule-based mind maps
-        run: python tools/generate_mindmaps.py --html
+      - name: Generate Mind Maps (Markdown + HTML)
+        run: |
+          python tools/generate_mindmaps.py        # Generate Markdown
+          python tools/generate_mindmaps.py --html # Generate HTML
       
       # Note: AI mindmaps are NOT generated in CI/CD
       # They must be manually generated and committed to the repository
       # See Step 3.2 for manual generation instructions
 
       - name: Build MkDocs site
-        run: python -m mkdocs build
+        run: mkdocs build
+      
+      - name: Copy mind map HTML files
+        run: |
+          cp -r docs/pages/mindmaps site/pages/mindmaps
+          cp -r docs/pages/assets site/pages/assets 2>/dev/null || true
       
       - name: Setup Pages
         uses: actions/configure-pages@v4
@@ -354,6 +367,17 @@ jobs:
         uses: actions/deploy-pages@v4
 ```
 
+### 4.2 What CI/CD Generates
+
+| File Type | Generated By | Tracked in Git |
+|-----------|--------------|----------------|
+| `docs/mindmaps/*.md` (rule-based) | CI/CD | ❌ No |
+| `docs/pages/mindmaps/*.html` (rule-based) | CI/CD | ❌ No |
+| `docs/mindmaps/neetcode_ontology_ai_*.md` | Manual | ✅ Yes |
+| `docs/pages/mindmaps/neetcode_ontology_ai_*.html` | Manual | ✅ Yes |
+| `docs/mindmaps/index.md` | Manual | ✅ Yes |
+| `docs/mindmaps/README.md` | Manual | ✅ Yes |
+
 ---
 
 ## Step 5: Enable GitHub Pages
@@ -414,17 +438,24 @@ The README.md already includes links to interactive mind maps:
    ↓
 3. GitHub Actions automatically triggers
    ↓
-4. Generate rule-based mind maps (Markdown + HTML)
-   python tools/generate_mindmaps.py --html
+4. Generate rule-based mind maps
+   python tools/generate_mindmaps.py        # Markdown
+   python tools/generate_mindmaps.py --html # HTML
    ↓
 5. Build MkDocs site
-   python -m mkdocs build
+   mkdocs build
    ↓
-6. Deploy to GitHub Pages
+6. Copy HTML files to site/
+   cp -r docs/pages/mindmaps site/pages/mindmaps
    ↓
-7. Visit https://yourusername.github.io/neetcode/
+7. Deploy to GitHub Pages
+   ↓
+8. Visit https://lufftw.github.io/neetcode/
 ```
 
+> **Note**: Rule-based Markdown files (`docs/mindmaps/*.md`) are NOT tracked in Git.
+> They are generated fresh by CI/CD on every deployment.
+
 ### AI-Powered Mind Maps (Manual Process)
 
 ```
@@ -530,7 +561,20 @@ Both are gitignored and regenerated on build/deploy.
 
 ## 📝 Notes
 
-- **Local Development**: Always test locally with `python -m mkdocs build` and `python -m mkdocs serve` before pushing
+- **Local Development**: Always test locally with `mkdocs build` and `mkdocs serve` before pushing
 - **Build Output**: The `site/` directory contains the complete MkDocs site and is gitignored
-- **Mind Maps**: HTML mind maps are generated to `docs/pages/mindmaps/` and are also gitignored
+- **Generated Files**: Both Markdown (`docs/mindmaps/*.md`) and HTML (`docs/pages/mindmaps/*.html`) mind maps are gitignored (except AI and manual files)
 - **Auto Deployment**: GitHub Actions handles generation, building, and deployment automatically
+- **AI Mind Maps**: Must be generated manually and committed (require API key, not in CI/CD)
+
+### Version Control Summary
+
+| File | Tracked | Reason |
+|------|---------|--------|
+| `docs/mindmaps/index.md` | ✅ | Manual index page |
+| `docs/mindmaps/README.md` | ✅ | Manual documentation |
+| `docs/mindmaps/neetcode_ontology_ai_*.md` | ✅ | AI generated (costly) |
+| `docs/mindmaps/*.md` (others) | ❌ | CI/CD generates |
+| `docs/pages/mindmaps/neetcode_ontology_ai_*.html` | ✅ | AI generated (costly) |
+| `docs/pages/mindmaps/*.html` (others) | ❌ | CI/CD generates |
+| `site/` | ❌ | MkDocs build output |

docs/mindmaps/README.md

@@ -0,0 +1,66 @@
+---
+title: NeetCode Mind Maps Index
+markmap:
+  colorFreezeLevel: 2
+  maxWidth: 400
+---
+
+# Mind Maps Index
+
+Visual mind maps of the NeetCode ontology and problem relationships.
+Use [markmap](https://markmap.js.org/) VSCode extension or web viewer.
+
+## Available Mind Maps
+
+### [📐 Pattern Hierarchy](pattern_hierarchy.md)
+
+API Kernels → Patterns → Problems hierarchy
+
+### [👨‍👩‍👧‍👦 Family Derivation](family_derivation.md)
+
+Base templates and derived problem variants
+
+### [⚡ Algorithm Usage](algorithm_usage.md)
+
+Which algorithms are used in which problems
+
+### [🏗️ Data Structure Usage](data_structure.md)
+
+Data structures used across problems
+
+### [🏢 Company Coverage](company_coverage.md)
+
+Problems frequently asked by companies
+
+### [🗺️ Learning Roadmaps](roadmap_paths.md)
+
+Learning roadmap structures
+
+### [🔗 Problem Relations](problem_relations.md)
+
+Related problems network
+
+### [🔀 Solution Variants](solution_variants.md)
+
+Problems with multiple solution approaches
+
+### [📊 Difficulty × Topics](difficulty_topics.md)
+
+Topics organized by difficulty level
+
+---
+
+## How to View
+
+### Option 1: VSCode Extension
+1. Install [markmap](https://marketplace.visualstudio.com/items?itemName=gera2ld.markmap-vscode)
+2. Open any `.md` file
+3. Click the markmap icon
+
+### Option 2: Web Viewer
+1. Go to [markmap.js.org](https://markmap.js.org/repl)
+2. Paste the markdown content
+
+---
+
+*Auto-generated by `tools/generate_mindmaps.py`*