docs: reorganizing documentation to make things clearer (#3658)

Signed-off-by: athreesh <anish.maddipoti@utexas.edu>
Co-authored-by: Claude <noreply@anthropic.com>

docs/guides/health_check.md → docs/observability/health-checks.md

@@ -197,4 +197,4 @@ date: Wed, 03 Sep 2025 13:42:45 GMT
 
 - [Distributed Runtime Architecture](../architecture/distributed_runtime.md)
 - [Dynamo Architecture Overview](../architecture/architecture.md)
-- [Backend Guide](backend.md)
+- [Backend Guide](../development/backend-guide.md)

docs/guides/logging.md → docs/observability/logging.md

@@ -187,5 +187,5 @@ curl -d '{"model": "Qwen/Qwen3-0.6B", "max_completion_tokens": 2049, "messages":
 
 - [Distributed Runtime Architecture](../architecture/distributed_runtime.md)
 - [Dynamo Architecture Overview](../architecture/architecture.md)
-- [Backend Guide](backend.md)
+- [Backend Guide](../development/backend-guide.md)
 - [Log Aggregation in Kubernetes](../kubernetes/logging.md)

docs/guides/metrics.md → docs/observability/metrics.md

@@ -96,6 +96,6 @@ The metrics system includes a pre-configured Grafana dashboard for visualizing s
 
 - [Distributed Runtime Architecture](../architecture/distributed_runtime.md)
 - [Dynamo Architecture Overview](../architecture/architecture.md)
-- [Backend Guide](backend.md)
+- [Backend Guide](../development/backend-guide.md)
 - [Metrics Implementation Examples](../../deploy/metrics/README.md#implementation-examples)
 - [Complete Metrics Setup Guide](../../deploy/metrics/README.md)
\ No newline at end of file

docs/architecture/planner_intro.rst → docs/planner/planner_intro.rst

@@ -29,7 +29,7 @@ Key features include:
 .. admonition:: 🚀 Quick Start
    :class: seealso
 
-   **New to SLA Planner?** Start with the [SLA Planner Quick Start Guide](/docs/kubernetes/sla_planner_quickstart.md) for a complete, step-by-step workflow.
+   **New to SLA Planner?** Start with the [SLA Planner Quick Start Guide](/docs/planner/sla_planner_quickstart.md) for a complete, step-by-step workflow.
 
    **Prerequisites**: SLA-based planner requires pre-deployment profiling (2-4 hours on real silicon or a few minutes using simulator) before deployment. The Quick Start guide includes everything you need.
 
@@ -77,6 +77,6 @@ Key features include:
    :hidden:
 
    Overview <self>
-   SLA Planner Quick Start <../kubernetes/sla_planner_quickstart>
+   SLA Planner Quick Start <sla_planner_quickstart>
    Pre-Deployment Profiling <../benchmarks/pre_deployment_profiling.md>
    SLA-based Planner <sla_planner.md>

docs/architecture/sla_planner.md → docs/planner/sla_planner.md

 # SLA-based Planner
 
 > [!TIP]
-> **New to SLA Planner?** For a complete workflow including profiling and deployment, see the [SLA Planner Quick Start Guide](/docs/kubernetes/sla_planner_quickstart.md).
+> **New to SLA Planner?** For a complete workflow including profiling and deployment, see the [SLA Planner Quick Start Guide](/docs/planner/sla_planner_quickstart.md).
 
 This document covers information regarding the SLA-based planner in `examples/common/utils/planner_core.py`.
 
@@ -129,7 +129,7 @@ Finally, SLA planner applies the change by scaling up/down the number of prefill
 
 ## Deploying
 
-For complete deployment instructions, see the [SLA Planner Quick Start Guide](/docs/kubernetes/sla_planner_quickstart.md).
+For complete deployment instructions, see the [SLA Planner Quick Start Guide](/docs/planner/sla_planner_quickstart.md).
 
 > [!NOTE]
 > The SLA planner requires a frontend that reports metrics at the `/metrics` HTTP endpoint with the number of requests, ISL, OSL, TTFT, and ITL in the correct format. The dynamo frontend provides these metrics automatically.

docs/kubernetes/sla_planner_quickstart.md → docs/planner/sla_planner_quickstart.md

@@ -249,7 +249,7 @@ This is because the `subComponentType` field has only been added in newer versio
 
 ## Next Steps
 
-- **Architecture Details**: See [SLA-based Planner Architecture](/docs/architecture/sla_planner.md) for technical details
+- **Architecture Details**: See [SLA-based Planner Architecture](/docs/planner/sla_planner.md) for technical details
 - **Performance Tuning**: See [Pre-Deployment Profiling Guide](/docs/benchmarks/pre_deployment_profiling.md) for advanced profiling options
 - **Load Testing**: See [SLA Planner Load Test](/tests/planner/README.md) for comprehensive testing tools
 

lib/bindings/python/README.md

@@ -50,7 +50,7 @@ maturin develop --uv
 
 ### Prerequisite
 
-See [README.md](../../../docs/runtime/README.md#prerequisites).
+See [README.md](../../../docs/development/runtime-guide.md#prerequisites).
 
 ### Hello World Example