Add placeholder top-level doc pages

GregoryComer · GregoryComer · commit 270569a115fb · 2025-02-06T13:14:13.000-08:00
diff --git a/backends/vulkan/README.md b/backends/vulkan/README.md
@@ -1,4 +1,4 @@
-# ExecuTorch Vulkan Delegate
+# Vulkan Backend
 
 The ExecuTorch Vulkan delegate is a native GPU delegate for ExecuTorch that is
 built on top of the cross-platform Vulkan GPU API standard. It is primarily
diff --git a/docs/source/concepts.md b/docs/source/concepts.md
@@ -1,4 +1,4 @@
-# ExecuTorch Concepts
+# Concepts
 This page provides an overview of key concepts and terms used throughout the ExecuTorch documentation. It is intended to help readers understand the terminology and concepts used in PyTorch Edge and ExecuTorch.
 
 ## Concepts Map
diff --git a/docs/source/getting-started-architecture.md b/docs/source/getting-started-architecture.md
@@ -1,4 +1,4 @@
-# High-level Architecture and Components of ExecuTorch
+# Architecture and Components
 
 This page describes the technical architecture of ExecuTorch and its individual components. This document is targeted towards engineers who are deploying PyTorch model onto edge devices.
 
diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -81,13 +81,30 @@ Topics in this section will help you get started with ExecuTorch.
 .. toctree::
    :glob:
    :maxdepth: 1
-   :caption: Getting Started
+   :caption: Usage
    :hidden:
 
    getting-started
-   export-overview
-   runtime-build-and-cross-compilation
-   getting-started-faqs
+   using-executorch-export
+   using-executorch-android
+   using-executorch-ios
+   using-executorch-cpp
+   using-executorch-troubleshooting
+
+.. toctree::
+   :glob:
+   :maxdepth: 1
+   :caption: Backend Delegates
+   :hidden:
+
+   native-delegates-executorch-xnnpack-delegate
+   native-delegates-executorch-coreml-delegate
+   native-delegates-executorch-mps-delegate
+   native-delegates-executorch-vulkan-delegate
+   native-delegates-executorch-arm-delegate
+   native-delegates-executorch-qualcomm-delegate
+   native-delegates-executorch-mediatek-delegate
+   native-delegates-executorch-cadence-delegate
 
 .. toctree::
    :glob:
@@ -118,105 +135,103 @@ Topics in this section will help you get started with ExecuTorch.
 
 .. toctree::
    :glob:
-   :maxdepth: 2
-   :caption: Working with LLMs
+   :maxdepth: 1
+   :caption: Developer Tools
    :hidden:
 
-   Llama <llm/llama>
-   Llama on Android <llm/llama-demo-android>
-   Llama on iOS <llm/llama-demo-ios>
-   Llama on Android via Qualcomm backend <llm/build-run-llama3-qualcomm-ai-engine-direct-backend>
-   Intro to LLMs in Executorch <llm/getting-started>
+   devtools-overview
+   bundled-io
+   etrecord
+   etdump
+   runtime-profiling
+   model-debugging
+   model-inspector
+   memory-planning-inspection
+   delegate-debugging
+   devtools-tutorial
 
 .. toctree::
    :glob:
    :maxdepth: 1
-   :caption: API Reference
+   :caption: Runtime
    :hidden:
 
-   export-to-executorch-api-reference
-   executorch-runtime-api-reference
-   runtime-python-api-reference
-   api-life-cycle
+   runtime-overview
+   runtime-backend-delegate-implementation-and-linking
+   runtime-platform-abstraction-layer
+   portable-cpp-programming
+   pte-file-format
 
 .. toctree::
    :glob:
    :maxdepth: 1
-   :caption: IR Specification
+   :caption: API Reference
    :hidden:
 
-   ir-exir
-   ir-ops-set-definition
+   export-to-executorch-api-reference
+   executorch-runtime-api-reference
+   runtime-python-api-reference
+   api-life-cycle
 
 .. toctree::
    :glob:
    :maxdepth: 1
-   :caption: Compiler Entry Points
+   :caption: Quantization
    :hidden:
 
-   compiler-delegate-and-partitioner
-   compiler-backend-dialect
-   compiler-custom-compiler-passes
-   compiler-memory-planning
+   quantization-overview
 
 .. toctree::
    :glob:
    :maxdepth: 1
-   :caption: Runtime
+   :caption: Kernel Library
    :hidden:
 
-   runtime-overview
-   runtime-backend-delegate-implementation-and-linking
-   runtime-platform-abstraction-layer
-   portable-cpp-programming
-   pte-file-format
+   kernel-library-overview
+   kernel-library-custom-aten-kernel
+   kernel-library-selective-build
 
 .. toctree::
    :glob:
-   :maxdepth: 1
-   :caption: Quantization
+   :maxdepth: 2
+   :caption: Working with LLMs
    :hidden:
 
-   quantization-overview
+   Llama <llm/llama>
+   Llama on Android <llm/llama-demo-android>
+   Llama on iOS <llm/llama-demo-ios>
+   Llama on Android via Qualcomm backend <llm/build-run-llama3-qualcomm-ai-engine-direct-backend>
+   Intro to LLMs in Executorch <llm/getting-started>
 
 .. toctree::
    :glob:
    :maxdepth: 1
-   :caption: Kernel Library
+   :caption: Backend Development
    :hidden:
 
-   kernel-library-overview
-   kernel-library-custom-aten-kernel
-   kernel-library-selective-build
+   backend-delegates-integration
+   backend-delegates-dependencies
+   debug-backend-delegate
 
 .. toctree::
    :glob:
    :maxdepth: 1
-   :caption: Backend Delegates
+   :caption: IR Specification
    :hidden:
 
-   native-delegates-executorch-xnnpack-delegate
-   native-delegates-executorch-vulkan-delegate
-   backend-delegates-integration
-   backend-delegates-dependencies
-   debug-backend-delegate
+   ir-exir
+   ir-ops-set-definition
 
 .. toctree::
    :glob:
    :maxdepth: 1
-   :caption: Developer Tools
+   :caption: Compiler Entry Points
    :hidden:
 
-   devtools-overview
-   bundled-io
-   etrecord
-   etdump
-   runtime-profiling
-   model-debugging
-   model-inspector
-   memory-planning-inspection
-   delegate-debugging
-   devtools-tutorial
+   compiler-delegate-and-partitioner
+   compiler-backend-dialect
+   compiler-custom-compiler-passes
+   compiler-memory-planning
 
 .. toctree::
    :glob:
diff --git a/docs/source/native-delegates-executorch-arm-delegate.md b/docs/source/native-delegates-executorch-arm-delegate.md
@@ -0,0 +1,3 @@
+# ARM Backend
+
+Placeholder
diff --git a/docs/source/native-delegates-executorch-cadence-delegate.md b/docs/source/native-delegates-executorch-cadence-delegate.md
@@ -0,0 +1,3 @@
+# Cadence Backend
+
+Placeholder
diff --git a/docs/source/native-delegates-executorch-coreml-delegate.md b/docs/source/native-delegates-executorch-coreml-delegate.md
@@ -0,0 +1,3 @@
+# Core ML Backend
+
+Placeholder for Core ML delegate docs
diff --git a/docs/source/native-delegates-executorch-mediatek-delegate.md b/docs/source/native-delegates-executorch-mediatek-delegate.md
@@ -0,0 +1,3 @@
+# MediaTek Backend
+
+Placeholder
diff --git a/docs/source/native-delegates-executorch-mps-delegate.md b/docs/source/native-delegates-executorch-mps-delegate.md
@@ -0,0 +1,3 @@
+# MPS Backend
+
+Placeholder
diff --git a/docs/source/native-delegates-executorch-qualcomm-delegate.md b/docs/source/native-delegates-executorch-qualcomm-delegate.md
@@ -0,0 +1,3 @@
+# Qualcomm Backend
+
+Placeholder
diff --git a/docs/source/native-delegates-executorch-xnnpack-delegate.md b/docs/source/native-delegates-executorch-xnnpack-delegate.md
@@ -1,4 +1,4 @@
-# ExecuTorch XNNPACK delegate
+# XNNPACK Backend
 
 This is a high-level overview of the ExecuTorch XNNPACK backend delegate. This high performance delegate is aimed to reduce CPU inference latency for ExecuTorch models. We will provide a brief introduction to the XNNPACK library and explore the delegate’s overall architecture and intended use cases.
 
diff --git a/docs/source/tutorials_source/bundled_program.bp b/docs/source/tutorials_source/bundled_program.bp
diff --git a/docs/source/using-executorch-android.md b/docs/source/using-executorch-android.md
@@ -0,0 +1,3 @@
+# Using ExecuTorch on Android
+
+Placeholder for top-level Android documentation
diff --git a/docs/source/using-executorch-cpp.md b/docs/source/using-executorch-cpp.md
@@ -0,0 +1,3 @@
+# Using ExecuTorch with C++
+
+Placeholder for top-level C++ documentation
diff --git a/docs/source/using-executorch-export.md b/docs/source/using-executorch-export.md
@@ -0,0 +1,3 @@
+# Model Export
+
+Placeholder for top-level export documentation
diff --git a/docs/source/using-executorch-ios.md b/docs/source/using-executorch-ios.md
@@ -0,0 +1,3 @@
+# Using ExecuTorch on iOS
+
+Placeholder for top-level iOS documentation
diff --git a/docs/source/using-executorch-troubleshooting.md b/docs/source/using-executorch-troubleshooting.md
@@ -0,0 +1,3 @@
+# Troubleshooting, Profiling, and Optimization
+
+Placeholder for top-level troubleshooting, profiling, and devtool docs

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# ExecuTorch Vulkan Delegate`
	`1`	`+# Vulkan Backend`
`2`	`2`
`3`	`3`	`The ExecuTorch Vulkan delegate is a native GPU delegate for ExecuTorch that is`
`4`	`4`	`built on top of the cross-platform Vulkan GPU API standard. It is primarily`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# ExecuTorch Concepts`
	`1`	`+# Concepts`
`2`	`2`	`This page provides an overview of key concepts and terms used throughout the ExecuTorch documentation. It is intended to help readers understand the terminology and concepts used in PyTorch Edge and ExecuTorch.`
`3`	`3`
`4`	`4`	`## Concepts Map`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# High-level Architecture and Components of ExecuTorch`
	`1`	`+# Architecture and Components`
`2`	`2`
`3`	`3`	`This page describes the technical architecture of ExecuTorch and its individual components. This document is targeted towards engineers who are deploying PyTorch model onto edge devices.`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Cadence Backend`
	`2`	`+`
	`3`	`+Placeholder`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Core ML Backend`
	`2`	`+`
	`3`	`+Placeholder for Core ML delegate docs`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# MediaTek Backend`
	`2`	`+`
	`3`	`+Placeholder`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Qualcomm Backend`
	`2`	`+`
	`3`	`+Placeholder`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# ExecuTorch XNNPACK delegate`
	`1`	`+# XNNPACK Backend`
`2`	`2`
`3`	`3`	`This is a high-level overview of the ExecuTorch XNNPACK backend delegate. This high performance delegate is aimed to reduce CPU inference latency for ExecuTorch models. We will provide a brief introduction to the XNNPACK library and explore the delegate’s overall architecture and intended use cases.`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Using ExecuTorch on Android`
	`2`	`+`
	`3`	`+Placeholder for top-level Android documentation`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Using ExecuTorch with C++`
	`2`	`+`
	`3`	`+Placeholder for top-level C++ documentation`