Fix top navbar and left sidebar navigation, adding pathways

docs/source/index.md

@@ -11,6 +11,64 @@
 
 ---
 
+## 🗺️ Find Your Path
+
+Not sure where to start? Use the guided pathways to navigate ExecuTorch based on your experience level, goal, and target platform.
+
+::::{grid} 3
+:gutter: 3
+
+:::{grid-item-card} 🟢 New to ExecuTorch
+:class-header: bg-success text-white
+:link: pathway-beginner
+:link-type: doc
+
+Step-by-step learning sequence from installation to your first on-device deployment. Includes concept explanations and worked examples.
+
++++
+**Beginner Pathway →**
+:::
+
+:::{grid-item-card} 🟡 Get Running Fast
+:class-header: bg-warning text-dark
+:link: pathway-quickstart
+:link-type: doc
+
+Skip the theory — get a model running in 15 minutes. Includes export cheat sheets, backend selection tables, and platform quick starts.
+
++++
+**Quick Start Pathway →**
+:::
+
+:::{grid-item-card} 🔴 Production & Advanced
+:class-header: bg-danger text-white
+:link: pathway-advanced
+:link-type: doc
+
+Quantization, custom backends, C++ runtime, LLM deployment, and compiler internals for production-grade systems.
+
++++
+**Advanced Pathway →**
+:::
+
+::::
+
+::::{grid} 1
+
+:::{grid-item-card} 🔀 Decision Matrix — Route by Goal, Platform & Model
+:link: user-pathways
+:link-type: doc
+
+Not sure which pathway fits? The decision matrix routes you by experience level, target platform, model status, and developer role to the exact documentation you need.
+
++++
+**View Decision Matrix →**
+:::
+
+::::
+
+---
+
 ## 🎯 Wins & Success Stories
 
 ::::{grid} 1
@@ -186,6 +244,7 @@ Profile, debug, and inspect your models with comprehensive tooling.
 
 intro-section
 quick-start-section
+user-pathways
 edge-platforms-section
 backends-section
 llm/working-with-llms

docs/source/intro-section.md

@@ -6,14 +6,39 @@ Overview, architecture, and core concepts of ExecuTorch.
 
 ExecuTorch is PyTorch's solution for training and inference on the Edge, providing portability, productivity, and performance for edge computing platforms.
 
+---
+
+## New to ExecuTorch? Start Here
+
+::::{grid} 2
+:gutter: 2
+
+:::{grid-item-card} 🟢 Beginner Pathway
+:link: pathway-beginner
+:link-type: doc
+
+A structured, step-by-step learning sequence for engineers new to on-device deployment. Covers concepts, setup, export, and your first device deployment.
+:::
+
+:::{grid-item-card} 🔀 Decision Matrix
+:link: user-pathways
+:link-type: doc
+
+Route yourself to the right documentation based on your experience level, target platform, model status, and developer role.
+:::
+
+::::
+
+---
+
 ## Getting Started with ExecuTorch
 
 New to ExecuTorch? Start with these foundational topics:
 
-- **{doc}`intro-overview`** - High-level overview of ExecuTorch capabilities
-- **{doc}`intro-how-it-works`** - Technical overview of the ExecuTorch workflow
-- **{doc}`getting-started-architecture`** - System architecture and components
-- **{doc}`concepts`** - Core concepts and terminology
+- **{doc}`intro-overview`** — High-level overview of ExecuTorch capabilities
+- **{doc}`intro-how-it-works`** — Technical overview of the ExecuTorch workflow
+- **{doc}`getting-started-architecture`** — System architecture and components
+- **{doc}`concepts`** — Core concepts and terminology
 
 ```{toctree}
 :hidden: