docs: restructure docs directory and move fern config to fern/ (#6700)

Signed-off-by: Neal Vaidya <nealv@nvidia.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

components/src/dynamo/vllm/args.py

@@ -305,7 +305,7 @@ def create_kv_events_config(
         "(matching upstream vLLM). To preserve current behavior, pass "
         "--kv-events-config explicitly. For example:\n"
         f'  --kv-events-config \'{{"enable_kv_cache_events":true,"publisher":"zmq","endpoint":"tcp://*:{port}"}}\'\n'
-        "See docs/pages/backends/vllm/README.md for details.",
+        "See docs/backends/vllm/README.md for details.",
         FutureWarning,
         stacklevel=2,
     )

deploy/discovery/README.md

@@ -5,4 +5,4 @@ SPDX-License-Identifier: Apache-2.0
 
 # Dynamo Service Discovery
 
-For documentation on Dynamo's service discovery system, see the [Service Discovery Guide](../../docs/pages/kubernetes/service-discovery.md).
+For documentation on Dynamo's service discovery system, see the [Service Discovery Guide](../../docs/kubernetes/service-discovery.md).

deploy/helm/charts/chrek/README.md

@@ -166,8 +166,8 @@ Ensure your storage class supports `ReadWriteMany` access mode for multi-node de
 
 ## Related Documentation
 
-- [ChReK Overview](../../../../docs/pages/kubernetes/chrek/README.md) - ChReK architecture and use cases
-- [ChReK with Dynamo Platform](../../../../docs/pages/kubernetes/chrek/dynamo.md) - Integration guide
+- [ChReK Overview](../../../../docs/kubernetes/chrek/README.md) - ChReK architecture and use cases
+- [ChReK with Dynamo Platform](../../../../docs/kubernetes/chrek/dynamo.md) - Integration guide
 
 ## License
 

deploy/helm/charts/platform/README.md

@@ -208,7 +208,7 @@ For detailed etcd configuration options, please refer to the official Bitnami et
 
 ## 📚 Additional Resources
 
-- [Dynamo Cloud Deployment Installation Guide](../../../../docs/pages/kubernetes/installation-guide.md)
+- [Dynamo Cloud Deployment Installation Guide](../../../../docs/kubernetes/installation-guide.md)
 - [NATS Documentation](https://docs.nats.io/)
 - [etcd Documentation](https://etcd.io/docs/)
 - [Kubernetes Operator Pattern](https://kubernetes.io/docs/concepts/extend-kubernetes/operator/)

deploy/helm/charts/platform/README.md.gotmpl

@@ -127,7 +127,7 @@ For detailed etcd configuration options, please refer to the official Bitnami et
 
 ## 📚 Additional Resources
 
-- [Dynamo Cloud Deployment Installation Guide](../../../../docs/pages/kubernetes/installation-guide.md)
+- [Dynamo Cloud Deployment Installation Guide](../../../../docs/kubernetes/installation-guide.md)
 - [NATS Documentation](https://docs.nats.io/)
 - [etcd Documentation](https://etcd.io/docs/)
 - [Kubernetes Operator Pattern](https://kubernetes.io/docs/concepts/extend-kubernetes/operator/)

deploy/helm/charts/platform/components/operator/crds/nvidia.com_dynamocomponentdeployments.yaml

@@ -71,7 +71,7 @@ spec:
                 autoscaling:
                   description: |-
                     Deprecated: This field is deprecated and ignored. Use DynamoGraphDeploymentScalingAdapter
-                    with HPA, KEDA, or Planner for autoscaling instead. See docs/pages/kubernetes/autoscaling.md
+                    with HPA, KEDA, or Planner for autoscaling instead. See docs/kubernetes/autoscaling.md
                     for migration guidance. This field will be removed in a future API version.
                   properties:
                     behavior:

deploy/helm/charts/platform/components/operator/crds/nvidia.com_dynamographdeployments.yaml

@@ -287,7 +287,7 @@ spec:
                       autoscaling:
                         description: |-
                           Deprecated: This field is deprecated and ignored. Use DynamoGraphDeploymentScalingAdapter
-                          with HPA, KEDA, or Planner for autoscaling instead. See docs/pages/kubernetes/autoscaling.md
+                          with HPA, KEDA, or Planner for autoscaling instead. See docs/kubernetes/autoscaling.md
                           for migration guidance. This field will be removed in a future API version.
                         properties:
                           behavior:

deploy/inference-gateway/README.md

@@ -5,4 +5,4 @@ SPDX-License-Identifier: Apache-2.0 -->
 
 Integrate Dynamo with the Gateway API Inference Extension for intelligent KV-aware request routing at the gateway layer.
 
-See [Inference Gateway documentation](../../docs/pages/kubernetes/inference-gateway.md) for full setup instructions, configuration options, and deployment examples.
+See [Inference Gateway documentation](../../docs/kubernetes/inference-gateway.md) for full setup instructions, configuration options, and deployment examples.

deploy/observability/README.md

 # Dynamo Observability
 
-For detailed documentation on Observability (Prometheus metrics, tracing, and logging), please refer to [docs/pages/observability/](../../docs/pages/observability/).
+For detailed documentation on Observability (Prometheus metrics, tracing, and logging), please refer to [docs/observability/](../../docs/observability/).

deploy/observability/grafana_dashboards/README.md

@@ -10,6 +10,6 @@ This directory contains example Grafana dashboards for Dynamo observability. The
 - `temp-loki.json` - Logging dashboard for Loki integration
 - `dashboard-providers.yml` - Configuration file for dashboard provisioning
 
-For setup instructions and usage, see [Observability Documentation](../../../docs/pages/observability/).
+For setup instructions and usage, see [Observability Documentation](../../../docs/observability/).
 
 For Kubernetes deployment setup, see [../k8s/MONITORING_SETUP.md](../k8s/MONITORING_SETUP.md).

deploy/observability/k8s/README.md

 # Dynamo Metrics Collection on Kubernetes
 
-For detailed documentation on collecting and visualizing metrics on Kubernetes, see [docs/pages/kubernetes/observability/metrics.md](../../../docs/pages/kubernetes/observability/metrics.md).
+For detailed documentation on collecting and visualizing metrics on Kubernetes, see [docs/kubernetes/observability/metrics.md](../../../docs/kubernetes/observability/metrics.md).

deploy/observability/k8s/logging/README.md

 # Dynamo Logging on Kubernetes
 
-For detailed documentation on collecting and visualizing logs on Kubernetes, see [docs/pages/kubernetes/observability/logging.md](../../../../docs/pages/kubernetes/observability/logging.md).
+For detailed documentation on collecting and visualizing logs on Kubernetes, see [docs/kubernetes/observability/logging.md](../../../../docs/kubernetes/observability/logging.md).

deploy/operator/Makefile

@@ -314,12 +314,12 @@ generate-api-docs: crd-ref-docs ## Generate API reference documentation from CRD
 		--output-path=./docs/api_reference.md
 	@echo "✅ Generated API reference at ./docs/api_reference.md"
 	# concatenate header.md, api_reference.md, and footer.md
-	cat docs/header.md ./docs/api_reference.md docs/footer.md > ../../docs/pages/kubernetes/api-reference.md
+	cat docs/header.md ./docs/api_reference.md docs/footer.md > ../../docs/kubernetes/api-reference.md
 	rm ./docs/api_reference.md
 	@echo "✅ Concatenated header.md, api_reference.md, and footer.md"
 	# Fix duplicate anchors: crd-ref-docs generates identical anchors for same-named types
 	# across API versions; prepend "v1beta1 " to affected v1beta1 headings and links.
-	python3 docs/fix-api-anchors.py ../../docs/pages/kubernetes/api-reference.md
+	python3 docs/fix-api-anchors.py ../../docs/kubernetes/api-reference.md
 
 HELM_CHART_DIR := ../helm/charts/platform
 

deploy/operator/README.md

@@ -33,4 +33,4 @@ make
 
 ### Install
 
-See [Dynamo Kubernetes Platform Installation Guide](/docs/pages/kubernetes/installation-guide.md) for installation instructions.
+See [Dynamo Kubernetes Platform Installation Guide](/docs/kubernetes/installation-guide.md) for installation instructions.

deploy/operator/api/v1alpha1/common.go

@@ -56,7 +56,7 @@ type VolumeMount struct {
 }
 
 // Deprecated: This field is deprecated and ignored. Use DynamoGraphDeploymentScalingAdapter
-// with HPA, KEDA, or Planner for autoscaling instead. See docs/pages/kubernetes/autoscaling.md
+// with HPA, KEDA, or Planner for autoscaling instead. See docs/kubernetes/autoscaling.md
 // for migration guidance. This field will be removed in a future API version.
 type Autoscaling struct {
 	// Deprecated: This field is ignored.

deploy/operator/api/v1alpha1/dynamocomponentdeployment_types.go

@@ -78,7 +78,7 @@ type DynamoComponentDeploymentSharedSpec struct {
 	// GPUs/devices, and any runtime-specific resources.
 	Resources *Resources `json:"resources,omitempty"`
 	// Deprecated: This field is deprecated and ignored. Use DynamoGraphDeploymentScalingAdapter
-	// with HPA, KEDA, or Planner for autoscaling instead. See docs/pages/kubernetes/autoscaling.md
+	// with HPA, KEDA, or Planner for autoscaling instead. See docs/kubernetes/autoscaling.md
 	// for migration guidance. This field will be removed in a future API version.
 	Autoscaling *Autoscaling `json:"autoscaling,omitempty"`
 	// Envs defines additional environment variables to inject into the component containers.

deploy/operator/config/crd/bases/nvidia.com_dynamocomponentdeployments.yaml

@@ -71,7 +71,7 @@ spec:
                 autoscaling:
                   description: |-
                     Deprecated: This field is deprecated and ignored. Use DynamoGraphDeploymentScalingAdapter
-                    with HPA, KEDA, or Planner for autoscaling instead. See docs/pages/kubernetes/autoscaling.md
+                    with HPA, KEDA, or Planner for autoscaling instead. See docs/kubernetes/autoscaling.md
                     for migration guidance. This field will be removed in a future API version.
                   properties:
                     behavior:

deploy/operator/config/crd/bases/nvidia.com_dynamographdeployments.yaml

@@ -287,7 +287,7 @@ spec:
                       autoscaling:
                         description: |-
                           Deprecated: This field is deprecated and ignored. Use DynamoGraphDeploymentScalingAdapter
-                          with HPA, KEDA, or Planner for autoscaling instead. See docs/pages/kubernetes/autoscaling.md
+                          with HPA, KEDA, or Planner for autoscaling instead. See docs/kubernetes/autoscaling.md
                           for migration guidance. This field will be removed in a future API version.
                         properties:
                           behavior:

deploy/operator/internal/webhook/validation/shared.go

@@ -109,7 +109,7 @@ func (v *SharedSpecValidator) Validate(ctx context.Context) (admission.Warnings,
 	if v.spec.Autoscaling != nil {
 		warnings = append(warnings, fmt.Sprintf(
 			"%s.autoscaling is deprecated and ignored. Use DynamoGraphDeploymentScalingAdapter "+
-				"with HPA, KEDA, or Planner for autoscaling instead. See docs/pages/kubernetes/autoscaling.md",
+				"with HPA, KEDA, or Planner for autoscaling instead. See docs/kubernetes/autoscaling.md",
 			v.fieldPath))
 	}
 

deploy/utils/README.md

@@ -6,7 +6,7 @@ This directory contains utilities and manifests for Dynamo benchmarking and prof
 
 **Before using these utilities, you must first set up Dynamo Kubernetes Platform following the main installation guide:**
 
-👉 **[Follow the Dynamo Kubernetes Platform installation guide](/docs/pages/kubernetes/installation-guide.md) to install the Dynamo Kubernetes Platform first.**
+👉 **[Follow the Dynamo Kubernetes Platform installation guide](/docs/kubernetes/installation-guide.md) to install the Dynamo Kubernetes Platform first.**
 
 This includes:
 1. Installing the Dynamo CRDs
@@ -144,8 +144,8 @@ kubectl delete pod pvc-access-pod -n $NAMESPACE
 #### Next Steps
 
 For complete benchmarking and profiling workflows:
-- **Benchmarking Guide**: See [docs/pages/benchmarks/benchmarking.md](../../docs/pages/benchmarks/benchmarking.md) for comparing DynamoGraphDeployments and external endpoints
-- **Pre-Deployment Profiling**: See [docs/pages/components/profiler/profiler-guide.md](../../docs/pages/components/profiler/profiler-guide.md) for optimizing configurations before deployment
+- **Benchmarking Guide**: See [docs/benchmarks/benchmarking.md](../../docs/benchmarks/benchmarking.md) for comparing DynamoGraphDeployments and external endpoints
+- **Pre-Deployment Profiling**: See [docs/components/profiler/profiler-guide.md](../../docs/components/profiler/profiler-guide.md) for optimizing configurations before deployment
 
 ## Notes