Fix README TOC and update Jekyll docs guide

README.md fixes:
- Update Table of Contents to include missing sections:
  * Add 'The Problem' section
  * Add 'The Solution' section
- Fix anchor for 'Supported Languages (62)' (was just '62')

docs/README.md updates:
- Replace jekyll-theme-minimal references with just-the-docs
- Document auto-generated files (getting-started, architecture, contributing)
- Explain single source of truth pattern
- Update theme customization instructions
- Update structure and references
- Add proper nav_order guidance for new pages

Cleanup:
- Remove empty docs/assets/css directory (not needed with just-the-docs)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

Author: sandeep-mewara

README.md

@@ -74,15 +74,17 @@ Examples:
 
 ## Table of Contents
 
-- [Why Infigraph](#why-infigraph-what-makes-it-unique) — What's unique in the market
+- [The Problem](#the-problem) — What Infigraph solves
+- [Why Infigraph](#why-infigraph-what-makes-it-unique) — Unique market position
+- [The Solution](#the-solution) — How it works
 - [Key Highlights](#key-highlights) — Core capabilities at a glance
 - [Quick Start](#quick-start) — Install and run in 2 minutes
 - [How It Works](#how-it-works) — Integration with AI coding agents
 - [Offline-First Design](#offline-first-design) — No APIs, no network calls
 - [Installation](#installation) — Setup for all platforms
 - [Usage Examples](#usage-examples) — CLI commands, Web UI, tasks
 - [Features & Architecture](#features--architecture) — Full capabilities list
-- [Supported Languages](#supported-languages-62) — All 62 languages
+- [Supported Languages (62)](#supported-languages-62) — All 62 languages
 - [Contributing](#contributing) — Build from source, add languages, contribute
 - [License](#license)
 

docs/README.md

@@ -1,6 +1,6 @@
 # Infigraph Documentation
 
-This directory contains the source for the Infigraph documentation site, built with Jekyll and deployed to GitHub Pages.
+This directory contains the source for the Infigraph documentation site, built with [Just the Docs](https://just-the-docs.github.io/) theme and deployed to GitHub Pages.
 
 ## Local Development
 
@@ -36,46 +36,65 @@ Output goes to `docs/_site/`
 
 ```
 docs/
-├── _config.yml           Jekyll configuration
-├── assets/
-│   └── css/style.scss    Custom stylesheet
-├── index.md              Landing page
-├── getting-started.md    Getting started guide
-├── architecture.md       Architecture & design document
-├── contributing.md       Contributing guidelines
-└── Gemfile              Ruby dependencies
+├── _config.yml              Jekyll configuration (Just the Docs theme)
+├── index.md                 Landing page (nav_order: 1)
+├── getting-started.md       Getting started (auto-generated, nav_order: 2)
+├── architecture.md          Architecture (auto-generated, nav_order: 3)
+├── contributing.md          Contributing (auto-generated, nav_order: 4)
+├── Gemfile                  Ruby dependencies
+└── README.md                This file
 ```
 
+**Auto-generated files** (derived from root sources):
+- `getting-started.md` — Extracted from README.md Quick Start section
+- `architecture.md` — Auto-generated from ARCHITECTURE.md
+- `contributing.md` — Auto-generated from CONTRIBUTING.md
+
+These files are in `.gitignore` and regenerated on every deployment.
+
 ## Adding a New Page
 
 1. Create a new `.md` file in the `docs/` directory
-2. Add YAML frontmatter:
+2. Add YAML frontmatter with nav_order:
    ```yaml
    ---
    layout: default
    title: Page Title
+   nav_order: 5
    ---
    ```
 3. Write content in Markdown
-4. Link from other pages using `[text](/infigraph/page-slug)`
+4. Links use Jekyll's `link` filter: `[text]({% link page.md %})`
 
 ## Deployment
 
-Documentation is automatically deployed to GitHub Pages when changes are pushed to `main` (triggered by updates to `docs/**` files).
+Documentation is automatically deployed to GitHub Pages when changes are pushed to `main`:
+- Triggers on: changes to `docs/**`, `ARCHITECTURE.md`, `CONTRIBUTING.md`, or `.github/workflows/pages.yml`
+- Workflow: `.github/workflows/pages.yml`
+- Site URL: https://intuit.github.io/infigraph/
+
+## Theme Configuration
 
-Site URL: https://intuit.github.io/infigraph/
+Uses [Just the Docs](https://just-the-docs.github.io/) — professional documentation theme with:
+- Sidebar navigation
+- Built-in search
+- Dark/light mode toggle
+- Mobile responsive design
+- Syntax highlighting
 
-## Theme
+To customize:
+- Edit `_config.yml` for site metadata, color scheme, and navigation links
+- Theme styling is built-in; no custom CSS needed
 
-Uses [jekyll-theme-minimal](https://github.com/pages-themes/minimal) with custom styling in `assets/css/style.scss`.
+## Single Source of Truth Pattern
 
-To modify the theme:
-- Edit `_config.yml` for site metadata and navigation
-- Edit `assets/css/style.scss` for styling
-- Modify layouts in `_includes/` or `_layouts/` (copied from theme)
+README.md is the source of truth. Jekyll pages derive from it:
+- Root `README.md` → docs pages via auto-generation
+- No duplication: pages are ephemeral, regenerated on every build
+- Edit root sources; Jekyll updates automatically
 
 ## References
 
+- [Just the Docs Documentation](https://just-the-docs.github.io/)
 - [Jekyll Documentation](https://jekyllrb.com/docs/)
 - [GitHub Pages with Jekyll](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll)
-- [Minimal Theme](https://pages-themes.github.io/minimal/)