dev.yml

# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
# SPDX-License-Identifier: Apache-2.0
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# Navigation structure matching https://docs.nvidia.com/dynamo/dev/
# Rebuilt to exactly replicate the rendered Sphinx sidebar

navigation:
  # ==================== Getting Started ====================
  - section: Getting Started
    contents:
      - page: Quickstart
        path: ../pages/getting-started/quickstart.md
      - page: Support Matrix
        path: ../pages/reference/support-matrix.md
      - page: Feature Matrix
        path: ../pages/reference/feature-matrix.md
      - page: Release Artifacts
        path: ../pages/reference/release-artifacts.md
      - page: Examples
        path: ../pages/getting-started/examples.md

  # ==================== Kubernetes Deployment ====================
  - section: Kubernetes Deployment
    contents:
      - section: Deployment Guide
        path: ../pages/kubernetes/README.md
        contents:
          - page: Detailed Installation Guide
            path: ../pages/kubernetes/installation-guide.md
          - page: Dynamo Operator
            path: ../pages/kubernetes/dynamo-operator.md
          - page: Service Discovery
            path: ../pages/kubernetes/service-discovery.md
          - page: Webhooks
            path: ../pages/kubernetes/webhooks.md
          - page: Minikube Setup
            path: ../pages/kubernetes/deployment/minikube.md
          - page: Managing Models with DynamoModel
            path: ../pages/kubernetes/deployment/dynamomodel-guide.md
          - page: Autoscaling
            path: ../pages/kubernetes/autoscaling.md
          - page: Inference Gateway (GAIE)
            path: ../pages/kubernetes/inference-gateway.md
          - section: Checkpointing
            path: ../pages/kubernetes/chrek/README.md
            contents:
              - page: Integration with Dynamo
                path: ../pages/kubernetes/chrek/dynamo.md
      - section: Observability (K8s)
        contents:
          - page: Metrics
            path: ../pages/kubernetes/observability/metrics.md
          - page: Logging
            path: ../pages/kubernetes/observability/logging.md
          - page: Operator Metrics
            path: ../pages/kubernetes/observability/operator-metrics.md
      - section: Multinode
        contents:
          - page: Multinode Deployments
            path: ../pages/kubernetes/deployment/multinode-deployment.md
          - page: Grove
            path: ../pages/kubernetes/grove.md

  # ==================== User Guides ====================
  - section: User Guides
    contents:
      - page: KV Cache Aware Routing
        path: ../pages/components/router/router-guide.md
      - page: Disaggregated Serving
        path: ../pages/features/disaggregated-serving/README.md
      - page: KV Cache Offloading
        path: ../pages/components/kvbm/kvbm-guide.md
      - page: Dynamo Benchmarking
        path: ../pages/benchmarks/benchmarking.md
      - section: Multimodality Support
        path: ../pages/features/multimodal/README.md
        contents:
          - page: vLLM Multimodal
            path: ../pages/features/multimodal/multimodal-vllm.md
          - page: TensorRT-LLM Multimodal
            path: ../pages/features/multimodal/multimodal-trtllm.md
          - page: SGLang Multimodal
            path: ../pages/features/multimodal/multimodal-sglang.md
      - page: Tool Calling
        path: ../pages/agents/tool-calling.md
      - page: SGLang for Agentic Workloads
        path: ../pages/backends/sglang/agents.md
      - page: LoRA Adapters
        path: ../pages/features/lora/README.md
      - section: Observability (Local)
        path: ../pages/observability/README.md
        contents:
          - page: Prometheus + Grafana Setup
            path: ../pages/observability/prometheus-grafana.md
          - page: Metrics
            path: ../pages/observability/metrics.md
          - page: Metrics Developer Guide
            path: ../pages/observability/metrics-developer-guide.md
          - page: Health Checks
            path: ../pages/observability/health-checks.md
          - page: Tracing
            path: ../pages/observability/tracing.md
          - page: Logging
            path: ../pages/observability/logging.md
      - section: Fault Tolerance
        path: ../pages/fault-tolerance/README.md
        contents:
          - page: Request Migration
            path: ../pages/fault-tolerance/request-migration.md
          - page: Request Cancellation
            path: ../pages/fault-tolerance/request-cancellation.md
          - page: Graceful Shutdown
            path: ../pages/fault-tolerance/graceful-shutdown.md
          - page: Request Rejection
            path: ../pages/fault-tolerance/request-rejection.md
          - page: Testing
            path: ../pages/fault-tolerance/testing.md
      - page: Writing Python Workers in Dynamo
        path: ../pages/development/backend-guide.md

  # ==================== Backends ====================
  - section: Backends
    contents:
      - section: SGLang
        path: ../pages/backends/sglang/README.md
        contents:
          - page: Reference Guide
            path: ../pages/backends/sglang/sglang-reference-guide.md
          - page: Examples
            path: ../pages/backends/sglang/sglang-examples.md
          - page: Disaggregation
            path: ../pages/backends/sglang/sglang-disaggregation.md
          - page: Diffusion
            path: ../pages/backends/sglang/sglang-diffusion.md
          - page: Observability
            path: ../pages/backends/sglang/sglang-observability.md
      - page: TensorRT-LLM
        path: ../pages/backends/trtllm/README.md
      - page: vLLM
        path: ../pages/backends/vllm/README.md

  # ==================== Components ====================
  - section: Components
    contents:
      - section: Frontend
        path: ../pages/components/frontend/README.md
        contents:
          - page: Frontend Guide
            path: ../pages/components/frontend/frontend-guide.md
      - section: Router
        path: ../pages/components/router/README.md
        contents:
          - page: Router Guide
            path: ../pages/components/router/router-guide.md
          - page: Router Examples
            path: ../pages/components/router/router-examples.md
      - section: Planner
        path: ../pages/components/planner/README.md
        contents:
          - page: Planner Guide
            path: ../pages/components/planner/planner-guide.md
          - page: Planner Examples
            path: ../pages/components/planner/planner-examples.md
      - section: Profiler
        path: ../pages/components/profiler/README.md
        contents:
          - page: Profiler Guide
            path: ../pages/components/profiler/profiler-guide.md
          - page: Profiler Examples
            path: ../pages/components/profiler/profiler-examples.md
      - section: KVBM
        path: ../pages/components/kvbm/README.md
        contents:
          - page: KVBM Guide
            path: ../pages/components/kvbm/kvbm-guide.md

  # ==================== Integrations ====================
  - section: Integrations
    contents:
      - page: LMCache
        path: ../pages/integrations/lmcache-integration.md
      - page: SGLang HiCache
        path: ../pages/integrations/sglang-hicache.md
      - page: FlexKV
        path: ../pages/integrations/flexkv-integration.md
      - page: KV Events for Custom Engines
        path: ../pages/integrations/kv-events-custom-engines.md

  # ==================== Design Docs ====================
  - section: Design Docs
    contents:
      - page: Overall Architecture
        path: ../pages/design-docs/architecture.md
      - page: Architecture Flow
        path: ../pages/design-docs/dynamo-flow.md
      - page: Disaggregated Serving
        path: ../pages/design-docs/disagg-serving.md
      - page: Distributed Runtime
        path: ../pages/design-docs/distributed-runtime.md
      - page: Discovery Plane
        path: ../pages/design-docs/discovery-plane.md
      - page: Request Plane
        path: ../pages/design-docs/request-plane.md
      - page: Event Plane
        path: ../pages/design-docs/event-plane.md
      - page: Router Design
        path: ../pages/design-docs/router-design.md
      - page: KVBM Design
        path: ../pages/design-docs/kvbm-design.md
      - page: Planner Design
        path: ../pages/design-docs/planner-design.md

  # ==================== Blog ====================
  - section: Blog
    path: ../blogs/index.mdx
    slug: blog
    contents:
      - page: "Flash Indexer: Inter-Galactic KV Routing"
        path: ../blogs/flash-indexer/flash-indexer.md
        slug: flash-indexer

  # ==================== Hidden Pages ====================
  # Pages accessible via direct URL but not shown in main navigation.
  # Matches Sphinx hidden_toctree.rst -- pages linked from within content
  # but not in the sidebar.
  - section: Additional Resources
    hidden: true
    contents:
      # -- Development --
      - page: Runtime Guide
        path: ../pages/development/runtime-guide.md
      - page: Jail Stream
        path: ../pages/development/jail-stream.md
      # -- API Reference --
      - section: NIXL Connect API
        path: ../pages/api/nixl-connect/README.md
        contents:
          - page: Connector
            path: ../pages/api/nixl-connect/connector.md
          - page: Device
            path: ../pages/api/nixl-connect/device.md
          - page: Device Kind
            path: ../pages/api/nixl-connect/device-kind.md
          - page: Descriptor
            path: ../pages/api/nixl-connect/descriptor.md
          - page: Read Operation
            path: ../pages/api/nixl-connect/read-operation.md
          - page: Write Operation
            path: ../pages/api/nixl-connect/write-operation.md
          - page: Readable Operation
            path: ../pages/api/nixl-connect/readable-operation.md
          - page: Writable Operation
            path: ../pages/api/nixl-connect/writable-operation.md
          - page: Operation Status
            path: ../pages/api/nixl-connect/operation-status.md
          - page: RDMA Metadata
            path: ../pages/api/nixl-connect/rdma-metadata.md
      # -- Kubernetes (hidden sub-pages) --
      - page: API Reference (K8s)
        path: ../pages/kubernetes/api-reference.md
      - page: Creating Deployments
        path: ../pages/kubernetes/deployment/create-deployment.md
      - page: FluxCD
        path: ../pages/kubernetes/fluxcd.md
      - page: Model Caching with Fluid
        path: ../pages/kubernetes/model-caching-with-fluid.md
      # -- Reference --
      - page: Glossary
        path: ../pages/reference/glossary.md
      - page: Tuning Disaggregated Performance
        path: ../pages/performance/tuning.md
      # -- Backend detail pages --
      - section: vLLM Details
        contents:
          - page: DeepSeek-R1
            path: ../pages/backends/vllm/deepseek-r1.md
          - page: GPT-OSS
            path: ../pages/backends/vllm/gpt-oss.md
          - page: Multi-Node
            path: ../pages/backends/vllm/multi-node.md
          - page: Prometheus
            path: ../pages/backends/vllm/prometheus.md
          - page: Prompt Embeddings
            path: ../pages/backends/vllm/prompt-embeddings.md
          - page: vLLM-Omni
            path: ../pages/backends/vllm/vllm-omni.md
      - section: TensorRT-LLM Details
        contents:
          - page: Multinode Examples
            path: ../pages/backends/trtllm/multinode/multinode-examples.md
          - page: Llama4 + Eagle
            path: ../pages/backends/trtllm/llama4-plus-eagle.md
          - page: KV Cache Transfer
            path: ../pages/backends/trtllm/kv-cache-transfer.md
          - page: Gemma3 Sliding Window
            path: ../pages/backends/trtllm/gemma3-sliding-window-attention.md
          - page: GPT-OSS
            path: ../pages/backends/trtllm/gpt-oss.md
          - page: Prometheus
            path: ../pages/backends/trtllm/prometheus.md
      # -- Features (hidden sub-pages) --
      - section: Speculative Decoding
        path: ../pages/features/speculative-decoding/README.md
        contents:
          - page: Speculative Decoding with vLLM
            path: ../pages/features/speculative-decoding/speculative-decoding-vllm.md
      # -- Benchmarks --
      - page: KV Router A/B Testing
        path: ../pages/benchmarks/kv-router-ab-testing.md
      # -- Mocker --
      - page: Mocker
        path: ../pages/mocker/mocker.md
      # -- Docs README --
      - page: Building Documentation
        path: ../pages/README.md
      # -- Templates --
      - section: Templates
        path: ../pages/templates/README.md
        contents:
          - page: Backend Guide
            path: ../pages/templates/backend-guide.md
          - page: Backend README
            path: ../pages/templates/backend-readme.md
          - page: Component Design
            path: ../pages/templates/component-design.md
          - page: Component Examples
            path: ../pages/templates/component-examples.md
          - page: Component Guide
            path: ../pages/templates/component-guide.md
          - page: Component README
            path: ../pages/templates/component-readme.md
          - page: Feature Backend
            path: ../pages/templates/feature-backend.md
          - page: Feature README
            path: ../pages/templates/feature-readme.md
          - page: In-Code README
            path: ../pages/templates/incode-readme.md
          - page: Infrastructure README
            path: ../pages/templates/infrastructure-readme.md
          - page: Integration README
            path: ../pages/templates/integration-readme.md